# Réponses multiples (/fr/api-playground/multiple-responses)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 411 · 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), [Ajouter des exemples de SDK](/fr/api-playground/adding-sdk-examples.md), [Gérer la visibilité des pages](/fr/api-playground/managing-page-visibility.md), [Créer manuellement des pages d'API](/fr/api-playground/mdx-setup.md)

Si votre API renvoie des réponses différentes selon les paramètres d’entrée, le contexte utilisateur ou d’autres conditions de la requête, vous pouvez documenter plusieurs exemples de réponses avec la propriété `examples`.

Ajoutez cette propriété à n’importe quelle réponse. Elle suit le schéma suivant.

```yaml
responses:
  "200":
    description: Réponse réussie
    content:
      application/json:
        schema:
          $ref: "#/components/schemas/YourResponseSchema"
        examples:
          us:
            summary: Réponse pour les États-Unis
            value:
              countryCode: "US"
              currencyCode: "USD"
              taxRate: 0.0825
          gb:
            summary: Réponse pour le Royaume-Uni
            value:
              countryCode: "GB"
              currencyCode: "GBP"
              taxRate: 0.20
```

Le playground traite également différemment les types de réponses non JSON selon leur type de contenu.

<div id="audio-response-examples">
  ## Exemples de réponses audio [#exemples-de-réponses-audio]
</div>

Pour les points de terminaison qui renvoient des fichiers audio, définissez le type de contenu de la réponse sur `audio/*` et fournissez l’URL d’un fichier audio comme exemple. Le playground affiche alors un lecteur audio interactif au lieu d’un extrait de code.

```yaml
responses:
  "200":
    description: Audio file generated successfully
    content:
      audio/mpeg:
        schema:
          type: string
          format: binary
        examples:
          sample:
            summary: Sample audio output
            value: "https://example.com/sample-audio.mp3"
```