---
title: Tiroir de code
slug: docs/fr/tiroir-de-code
createdAt: 2026-06-05T12:51:26.902Z
---

[Tiroir de code](docId\:aT88RIRxaZN_4pJmehl4c) affichent des exemples de requêtes et des exemples de réponses dans la colonne de droite d’une mise en page à deux colonnes. Utilisez-les pour créer une documentation API interactive.

## Syntaxe

Vous pouvez ajouter ce composant en utilisant soit Markdown soit MDX.

::::Tabs
:::Tab{title="Markdown"}
```markdown
::::CodeDrawer{title="Endpoint Name"}
:::CodeblockTabsExamples
(Code blocks with request examples)
:::
:::CodeblockTabsResponses
(Code blocks with response examples)
:::
::::
```
:::

:::Tab{title="MDX"}
```javascript
<CodeDrawer title="Endpoint Name">
  <CodeblockTabsExamples>
    (Code blocks with request examples)
  </CodeblockTabsExamples>
  <CodeblockTabsResponses>
    (Code blocks with response examples)
  </CodeblockTabsResponses>
</CodeDrawer>
```
:::
::::

Un tiroir de code se compose de deux sections :

- `CodeblockTabsExamples` pour les exemples de requêtes.&#x20;
- `CodeblockTabsResponses` pour les exemples de réponses.&#x20;

Chaque section peut contenir un ou plusieurs blocs de code délimités. Lorsque plusieurs blocs de code sont présents, ils sont automatiquement regroupés en onglets par langage.

Les tiroirs de code sont affichés dans la colonne de droite lorsqu’ils sont utilisés dans une mise en page à deux colonnes.

## Exemple MDX

L’exemple suivant crée un tiroir de code avec des exemples de requêtes en JavaScript, Python et Bash, ainsi que des réponses réussies et des réponses d’erreur.

````javascript
<CodeDrawer title="Create a User">
  <CodeblockTabsExamples>

  ```javascript
  const response = await fetch('https://api.example.com/users', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer sk_live_xxx'
    },
    body: JSON.stringify({
      name: 'Jane Doe',
      email: 'jane@example.com',
      role: 'admin'
    })
  })
  const user = await response.json()
  ```

  ```python
  import requests

  response = requests.post('https://api.example.com/users', json={
      'name': 'Jane Doe',
      'email': 'jane@example.com',
      'role': 'admin'
  }, headers={
      'Authorization': 'Bearer sk_live_xxx'
  })
  user = response.json()
  ```

  ```bash
  curl -X POST https://api.example.com/users \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk_live_xxx" \
    -d '{"name":"Jane Doe","email":"jane@example.com","role":"admin"}'
  ```

  </CodeblockTabsExamples>

  <CodeblockTabsResponses>

  ```json
  {
    "id": "usr_abc123",
    "name": "Jane Doe",
    "email": "jane@example.com",
    "role": "admin",
    "createdAt": "2026-04-01T10:00:00Z"
  }
  ```

  ```json
  {
    "error": "Validation failed",
    "message": "Email already exists",
    "code": 409
  }
  ```

  </CodeblockTabsResponses>
</CodeDrawer>
````