Especificación OpenAPI
Cada proyecto de API publicado expone automáticamente un documento OpenAPI 3.0 válido en /openapi.json en su URL base, sin necesidad de configuración. Lista la ruta, el método, y (para un endpoint protegido con clave) que necesita un token de portador de cada endpoint habilitado, además de un esquema real del cuerpo de la petición y respuestas de ejemplo construidas a partir de tus bloques de Validar y Respuesta. Importa esa URL directamente en Postman, Insomnia, o cualquier generador de cliente basado en OpenAPI.
Aceptar la subida de un archivo
Envía una petición con Content-Type: multipart/form-data y cualquier campo de archivo se sube automáticamente antes de que se ejecute la lógica de tu endpoint, el valor del campo se convierte en la URL pública de ese archivo, usable en cualquier lugar posterior (una Consulta de Base de Datos, un cuerpo de Respuesta) exactamente como cualquier otro campo.
Devolver un archivo en lugar de JSON
El tipo de un bloque de Respuesta o Respuesta de Error puede configurarse como Servir archivo directamente (obtiene una URL que le das y devuelve sus bytes reales, limitado a 4MB) o Redirigir (envía a quien llama directamente a la propia URL pública de un archivo en su lugar, sin límite de tamaño, ya que tu endpoint no es el que sirve los bytes). Redirigir es la mejor opción para cualquier cosa que pueda superar los 4MB.