Saltar al contenido principal
Si tu API devuelve respuestas diferentes según los parámetros de entrada, el contexto del usuario u otras condiciones de la solicitud, puedes documentar múltiples ejemplos de respuestas con la propiedad examples. Agrega esta propiedad a cualquier respuesta. Tiene el siguiente esquema.
El playground también maneja de forma diferente los tipos de respuesta que no son JSON según su tipo de contenido.

Ejemplos de respuestas de audio

Para los endpoints que devuelven archivos de audio, establece el tipo de contenido de la respuesta en audio/* y proporciona la URL de un archivo de audio como valor de ejemplo. El playground muestra un reproductor de audio interactivo en lugar de un fragmento de código.