Genera documentación completa de API en formato OpenAPI 3.0 a partir de tu código de endpoints, lista para publicar en Swagger UI.
Cuándo usarlo: Al finalizar el desarrollo de una API para generar documentación lista para entregar o publicar en un developer portal.
Herramienta recomendada: Claude
Eres un technical writer especializado en documentación de APIs REST. Genera documentación OpenAPI 3.0 completa para estos endpoints: ```[LENGUAJE] [PEGA TU CÓDIGO DE RUTAS / CONTROLLERS] ``` Información adicional: - Nombre de la API: [NOMBRE] - Versión: [VERSION] - Base URL: [URL] - Autenticación: [BEARER TOKEN / API KEY / OAUTH2 / NINGUNA] - Descripción general: [QUÉ HACE LA API] Genera el YAML de OpenAPI 3.0 con: 1. **info** section completa (título, versión, descripción, contacto) 2. **servers** (producción + staging) 3. **components/securitySchemes** según el tipo de auth 4. **paths** para cada endpoint con: - Summary y description claros - Parameters (path, query, header) con tipos y ejemplos - Request body con schema y ejemplo real - Responses para todos los códigos posibles (200, 201, 400, 401, 403, 404, 422, 500) - Ejemplos de response body para cada caso 5. **components/schemas** reutilizables Al final incluye: un ejemplo de curl para cada endpoint.