> ## 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

> Automatisez vos extraits d’utilisation de SDK dans le bac à sable d’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 de l’API Mintlify. Les extraits d’utilisation de SDK s’affichent dans le [bac à sable interactif](/fr/api-playground/overview) des sites de documentation propulsés par 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 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#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 [Speakeasy Dashboard](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/omer-914cc1c6/fcMjNrr23zmS_VHA/images/speakeasy/openapi-registry-and-combined-spec.png?fit=max&auto=format&n=fcMjNrr23zmS_VHA&q=85&s=180306a14dd7778b09264b6ad93e8d87" alt="Capture d’écran de la page Speakeasy API Registry. L’onglet API Registry est mis en évidence avec un carré rouge et le numéro 1, et l’entrée de l’API est mise en évidence avec un carré rouge et 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 indiquée comme **Combined Spec**, assurez-vous que l’API dispose d’une [URL de génération automatique d’exemples de code](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/omer-914cc1c6/fcMjNrr23zmS_VHA/images/speakeasy/copy-combined-spec-url.png?fit=max&auto=format&n=fcMjNrr23zmS_VHA&q=85&s=b183d321f0f2658f0f37ff31a0c805da" alt="Capture d’écran montrant l’entrée de registre de 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 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 API",
      "url": "api-reference",
      // !mark
      "openapi": "SPEAKEASY_COMBINED_SPEC_URL"
    }
  ]
}
```

Les extraits de code générés par Speakeasy peuvent désormais être affichés dans votre documentation d’API et testés dans l’aire de jeu.