Generador de documentación API

Genera documentación API para los siguientes endpoints.

Endpoint: [URL y método]
Autenticación: [tipo]
Cuerpo de la petición: [esquema o ejemplo]
Respuesta: [esquema o ejemplo]

Incluye:
1. Descripción breve
2. Parámetros de la petición (path, query, body)
3. Formato de respuesta con códigos de estado
4. Un ejemplo de petición/respuesta
5. Códigos de error y notas de manejo

Formatea como Markdown compatible con OpenAPI/Swagger.