> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Speakeasy

> Automatiza los fragmentos de uso del SDK en el área de pruebas de la API

Los fragmentos de código generados automáticamente a partir de los SDK de Speakeasy pueden integrarse directamente en la documentación de referencia de la API de Mintlify. Los fragmentos de uso del SDK se muestran en el [área de pruebas interactiva](/es/api-playground/overview) de los sitios de documentación creados con Mintlify.

<Frame>
  <img src="https://mintcdn.com/omer-914cc1c6/fcMjNrr23zmS_VHA/images/speakeasy/mintlify-with-speakeasy-openapi.png?fit=max&auto=format&n=fcMjNrr23zmS_VHA&q=85&s=ac9cb2d3f3a67c08dcd8c5e199bc42dc" alt="Un área de pruebas de la API de Mintlify con fragmentos de código de Speakeasy." width="2560" height="1440" data-path="images/speakeasy/mintlify-with-speakeasy-openapi.png" />
</Frame>

<div id="prerequisites">
  ## Requisitos previos
</div>

Para integrar Mintlify con Speakeasy, necesitarás lo siguiente:

* Un [repositorio de documentación de Mintlify](/es/quickstart#creating-the-repository).
* Un SDK generado por Speakeasy con una [URL de muestra de código automatizada](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls) configurada.

<div id="setting-up-the-integration">
  ## Configuración de la integración
</div>

Para integrar Speakeasy con Mintlify, debes obtener la URL pública de la especificación combinada de la API desde el registro y actualizar tu archivo de configuración `docs.json`.

<div id="get-the-apis-combined-spec-public-url-from-the-registry">
  ### Obtener la URL pública de la especificación combinada de la API desde el registro
</div>

Ve a tu [Speakeasy Dashboard](https://app.speakeasy.com) y abre la pestaña **API Registry**. Abre la entrada `*-with-code-samples` de la API.

<Frame>
  <img src="https://mintcdn.com/omer-914cc1c6/fcMjNrr23zmS_VHA/images/speakeasy/openapi-registry-and-combined-spec.png?fit=max&auto=format&n=fcMjNrr23zmS_VHA&q=85&s=180306a14dd7778b09264b6ad93e8d87" alt="Captura de pantalla de la página Speakeasy API Registry. La pestaña API Registry está resaltada con un cuadro rojo y el número 1, y la entrada de la API está resaltada con un cuadro rojo y el número 2." width="2560" height="1440" data-path="images/speakeasy/openapi-registry-and-combined-spec.png" />
</Frame>

<Note>
  Si la entrada no está etiquetada como **Combined Spec**, asegúrate de que la API tenga configurada una [URL automática de muestras de código](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls).
</Note>

Desde la página de la entrada en el registro, copia la URL pública proporcionada.

<Frame>
  <img src="https://mintcdn.com/omer-914cc1c6/fcMjNrr23zmS_VHA/images/speakeasy/copy-combined-spec-url.png?fit=max&auto=format&n=fcMjNrr23zmS_VHA&q=85&s=b183d321f0f2658f0f37ff31a0c805da" alt="Captura de pantalla que muestra la entrada del registro de la especificación combinada con la función de copiar URL resaltada con un cuadro rojo." width="2560" height="1440" data-path="images/speakeasy/copy-combined-spec-url.png" />
</Frame>

<div id="update-your-docsjson-configuration-file">
  ### Actualiza tu archivo de configuración `docs.json`
</div>

Agrega la URL de la especificación combinada a una sección de **Anchors** o **Tabs** en tu archivo `docs.json`.

Agrega la URL de la especificación combinada a un anchor actualizando el campo `anchor` en tu archivo `docs.json` de la siguiente manera:

```json docs.json theme={null}
{
  "anchors": [
    {
      "name": "Referencia de API",
      // !mark
      "openapi": "SPEAKEASY_COMBINED_SPEC_URL",
      "url": "api-reference",
      "icon": "square-terminal"
    }
  ]
}
```

Agrega la URL de la especificación combinada a un Tab actualizando el campo `tab` en el archivo `docs.json` de la siguiente manera:

```json docs.json theme={null}
{
  "tabs": [
    {
      "name": "Referencia de API",
      "url": "api-reference",
      // !mark
      "openapi": "SPEAKEASY_COMBINED_SPEC_URL"
    }
  ]
}
```

Ahora puedes ver los fragmentos de código generados por Speakeasy en la documentación de tu API e interactuar con ellos en el área de pruebas.