> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-97b9ea5c.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-mintlify-97b9ea5c/uuwXNP09J2nCFcmO/images/speakeasy/mintlify-with-speakeasy-openapi.png?fit=max&auto=format&n=uuwXNP09J2nCFcmO&q=85&s=942cde6868aa0dc8b371fd4240755552" 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-mintlify-97b9ea5c/uuwXNP09J2nCFcmO/images/speakeasy/openapi-registry-and-combined-spec.png?fit=max&auto=format&n=uuwXNP09J2nCFcmO&q=85&s=7cbf2d8fb9b389925c7c9d19cf2c3447" alt="Capture d’écran de la page Speakeasy API Registry. Un carré rouge avec le numéro 1 met en évidence l’onglet API Registry, et un carré rouge avec le numéro 2 met en évidence l’entrée de l’API." 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-mintlify-97b9ea5c/uuwXNP09J2nCFcmO/images/speakeasy/copy-combined-spec-url.png?fit=max&auto=format&n=uuwXNP09J2nCFcmO&q=85&s=2a18c09d9cbd8919546d1a65ec3deabf" 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.

<div id="verify-the-integration">
  ## Vérifier l'intégration
</div>

Après avoir redéployé votre documentation, ouvrez n'importe quel endpoint dans votre référence d'API et vérifiez que les extraits de code apparaissent dans le playground. L'ensemble des langages disponibles correspond aux cibles SDK configurées dans votre projet Speakeasy.

Si les extraits n'apparaissent pas, vérifiez que :

* L'URL `openapi` dans `docs.json` pointe vers l'entrée de spécification combinée `*-with-code-samples`, et non vers le fichier OpenAPI source.
* L'URL de la spécification combinée est accessible publiquement depuis le navigateur.
* Votre projet Speakeasy dispose d'une [URL d'échantillons de code automatisés](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls) configurée et d'au moins une cible SDK activée.