> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-add-hello-world-quickstart-48843.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Speakeasy

> Automatisez vos Snippets d’utilisation de SDK dans le Terrain de jeu API

Des extraits de code générés automatiquement à partir des SDK Speakeasy peuvent être intégrés directement dans la documentation de référence API de Mintlify. Des Snippets d’utilisation de SDK s’affichent dans le [terrain de jeu interactif](/fr/api-playground/overview) des sites de documentation propulsés par Mintlify.

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/9lElgRHqAJ6W2ryc/images/speakeasy/mintlify-with-speakeasy-openapi.png?fit=max&auto=format&n=9lElgRHqAJ6W2ryc&q=85&s=0b658d00b6bf7ef39f2c4ff716dad716" alt="Un Terrain de jeu 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 [dépôt de documentation Mintlify](/fr/quickstart#creating-the-repository).
* 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 et 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 [tableau de bord 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-add-hello-world-quickstart-48843/9lElgRHqAJ6W2ryc/images/speakeasy/openapi-registry-and-combined-spec.png?fit=max&auto=format&n=9lElgRHqAJ6W2ryc&q=85&s=6b8ef0dd8336bfe90c397dd3fc89ac88" 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 marquée **Combined Spec**, vérifiez que l’API a bien une [URL d’exemples de code automatisés](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls) configurée.
</Note>

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

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/9lElgRHqAJ6W2ryc/images/speakeasy/copy-combined-spec-url.png?fit=max&auto=format&n=9lElgRHqAJ6W2ryc&q=85&s=d3e37b95f08f742829ab7886b7ba383a" alt="Capture d’écran montrant l’entrée du registre pour la spécification combinée, avec la fonction de copie de l’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">
  ### Mettre à 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
{
  "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
{
  "tabs": [
    {
      "name": "Référence de l’API",
      "url": "api-reference",
      // !mark
      "openapi": "SPEAKEASY_COMBINED_SPEC_URL"
    }
  ]
}
```

Les Snippets générés par Speakeasy peuvent désormais être affichés dans votre documentation API et utilisés dans le terrain de jeu API.