> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-add-i-to-quickstart-8818.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 API

Los fragmentos de código autogenerados de los SDK de Speakeasy pueden integrarse directamente en la documentación de referencia de API de Mintlify. Estos 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/mintlify-mintlify-add-i-to-quickstart-8818/_whnusx_G1hcFltR/images/speakeasy/mintlify-with-speakeasy-openapi.png?fit=max&auto=format&n=_whnusx_G1hcFltR&q=85&s=67d652c20b6e16a8456511ae3ae6eb1a" alt="Un área de pruebas de 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
</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">
  ### Obtén la URL pública de la especificación combinada de la API desde el registro
</div>

Ve a tu [Panel de Speakeasy](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/mintlify-mintlify-add-i-to-quickstart-8818/_whnusx_G1hcFltR/images/speakeasy/openapi-registry-and-combined-spec.png?fit=max&auto=format&n=_whnusx_G1hcFltR&q=85&s=d757dc5324473e0ee6166f5b22b29309" 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 ejemplos de código](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls).
</Note>

En la página de la entrada del registro, copia la URL pública proporcionada.

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-add-i-to-quickstart-8818/_whnusx_G1hcFltR/images/speakeasy/copy-combined-spec-url.png?fit=max&auto=format&n=_whnusx_G1hcFltR&q=85&s=be6afacd1bb568d9f719d918e1575392" 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 ancla actualizando el campo `anchor` en tu archivo `docs.json` de la siguiente manera:

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

Añade la URL de la especificación combinada a una pestaña actualizando el campo `tab` en el archivo `docs.json` de la siguiente manera:

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

Los fragmentos de código generados por Speakeasy ahora pueden verse en tu documentación de la API y utilizarse en el área de pruebas de la API.