# Ajouter des exemples de SDK (/fr/api-playground/adding-sdk-examples)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 382 · updated: 2026-07-30 -->
Related: [Playground](/fr/api-playground/overview.md), [Configuration d’OpenAPI](/fr/api-playground/openapi-setup.md), [Types de données complexes](/fr/api-playground/complex-data-types.md), [Gérer la visibilité des pages](/fr/api-playground/managing-page-visibility.md), [Réponses multiples](/fr/api-playground/multiple-responses.md), [Créer manuellement des pages d'API](/fr/api-playground/mdx-setup.md)

Si vos utilisateurs interagissent avec votre API à l’aide d’un SDK plutôt que directement via une requête réseau, vous pouvez utiliser l’extension `x-codeSamples` pour ajouter des extraits de code à votre document OpenAPI et les afficher dans vos pages OpenAPI.

Ajoutez cette propriété à n’importe quelle méthode de requête. Elle a le schéma suivant.

<ParamField body="lang" type="string">
  La langue de l’extrait de code.
</ParamField>

<ParamField body="label" type="string">
  Le libellé de l’exemple. Utile lorsque vous fournissez plusieurs exemples pour un même endpoint.
</ParamField>

<ParamField body="source" type="string">
  Le code source de l’exemple.
</ParamField>

Voici un exemple d’extraits de code pour une application de suivi de plantes, qui propose à la fois un outil CLI Bash et un SDK JavaScript.

```yaml
paths:
  /plants:
    get:
      # ...
      x-codeSamples:
        - lang: bash
          label: Lister toutes les plantes non arrosées
          source: |
            planter list -u
        - lang: javascript
          label: Lister toutes les plantes non arrosées
          source: |
            const planter = require('planter');
            planter.list({ unwatered: true });
        - lang: bash
          label: Lister toutes les plantes en pot
          source: |
            planter list -p
        - lang: javascript
          label: Lister toutes les plantes en pot
          source: |
            const planter = require('planter');
            planter.list({ potted: true });
```