> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-docs-automation-github-pr-review.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Speakeasy

> Affichez des exemples de code SDK générés par Speakeasy dans votre playground d’API, avec des exemples multi-langages pour Python, TypeScript et Go.

Vous pouvez intégrer les extraits de code générés automatiquement à partir des SDK Speakeasy directement dans la documentation de référence d’API de Mintlify. Les exemples d’utilisation des SDK apparaissent dans le [bac à sable interactif](/fr/api-playground/overview) des sites de documentation propulsés par Mintlify.

<Frame>
  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/XpTZ81chTFZOX5fm/images/speakeasy/mintlify-with-speakeasy-openapi.png?fit=max&auto=format&n=XpTZ81chTFZOX5fm&q=85&s=1547498dc374860f04ea134701495dda" alt="Un bac à sable d’API Mintlify avec des extraits de code Speakeasy." width="2560" height="1440" data-path="images/speakeasy/mintlify-with-speakeasy-openapi.png" />
</Frame>

<div id="prerequisites">
  ## Prérequis
</div>

Pour intégrer Mintlify à Speakeasy, vous aurez besoin des éléments suivants :

* Un [référentiel de documentation Mintlify](/fr/quickstart).
  * Un SDK généré par Speakeasy avec une [URL d’exemples de code automatisés](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls) configurée.

<div id="setting-up-the-integration">
  ## Configuration de l’intégration
</div>

Pour intégrer Speakeasy à Mintlify, vous devez récupérer l’URL publique de la spécification combinée de l’API depuis le registre, puis mettre à jour votre fichier de configuration `docs.json`.

<div id="get-the-apis-combined-spec-public-url-from-the-registry">
  ### Récupérer l’URL publique de la spécification combinée de l’API depuis le registre
</div>

Accédez à votre [Dashboard Speakeasy](https://app.speakeasy.com) et ouvrez l’onglet **API Registry**. Ouvrez l’entrée `*-with-code-samples` de l’API.

<Frame>
  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/XpTZ81chTFZOX5fm/images/speakeasy/openapi-registry-and-combined-spec.png?fit=max&auto=format&n=XpTZ81chTFZOX5fm&q=85&s=b31dc7ceb7bab00d5df1f091482ebdf1" alt="Capture d’écran de la page Speakeasy API Registry. L’onglet API Registry est mis en évidence par un carré rouge avec le numéro 1 et l’entrée de l’API est mise en évidence par un carré rouge avec le numéro 2." width="2560" height="1440" data-path="images/speakeasy/openapi-registry-and-combined-spec.png" />
</Frame>

<Note>
  Si l’entrée n’est pas étiquetée **Combined Spec**, vérifiez que l’API a une [URL d’exemples de code automatisée](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls) configurée.
</Note>

Depuis la page de l’entrée du registre, copiez l’URL publique fournie.

<Frame>
  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/XpTZ81chTFZOX5fm/images/speakeasy/copy-combined-spec-url.png?fit=max&auto=format&n=XpTZ81chTFZOX5fm&q=85&s=10d723a02a303d63cce1578d4c63a2cf" alt="Capture d’écran montrant l’entrée du registre de la spécification combinée avec la fonction de copie d’URL mise en évidence par un carré rouge." width="2560" height="1440" data-path="images/speakeasy/copy-combined-spec-url.png" />
</Frame>

<div id="update-your-docsjson-configuration-file">
  ### Mettez à jour votre fichier de configuration `docs.json`
</div>

Ajoutez l’URL de la spécification combinée dans une section **Anchors** ou **Tabs** de votre fichier `docs.json`.

Ajoutez l’URL de la spécification combinée à une ancre en mettant à jour le champ `anchor` dans votre fichier `docs.json` comme suit :

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

Ajoutez l’URL de la spécification combinée à un onglet en mettant à jour le champ `tab` dans le fichier `docs.json` comme suit :

```json docs.json theme={null}
{
  "tabs": [
    {
      "name": "Référence de l'API",
      "url": "api-reference",
      // !mark
      "openapi": "SPEAKEASY_COMBINED_SPEC_URL"
    }
  ]
}
```

Vous pouvez désormais afficher les extraits de code générés par Speakeasy dans votre documentation d’API et interagir avec eux dans le playground.