> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Réponses multiples

> Documentez plusieurs variations de réponses pour vos endpoints d'API, succès et erreurs inclus, avec codes d'état et exemples de payload détaillés.

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 theme={null}
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
</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 theme={null}
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"
```