Spec OpenAPI

El mapa completo y legible por máquinas de la API: cada endpoint, petición, respuesta y error.

OpenAPI es el formato estándar de la industria para describir una API HTTP en un archivo legible por máquinas.

https://api.wontopos.com/openapi.json

Qué puedes hacer con esto

Postman: File → Import → pega la URL y todos los endpoints aparecen como colección clicable. ChatGPT: crea un GPT, añade una Action, pega la misma URL. Codegen: openapi-generator -i .../openapi.json -g go genera un cliente en un lenguaje que no publicamos.

Impórtalo en Postman, genera un cliente en un lenguaje que no publicamos, conecta ChatGPT Actions o ejecuta checks de contrato en CI. Un test lo fija a las rutas reales: no puede desviarse.

llms.txt

Toda la API en una página de texto que una IA puede leer.

llms.txt es una convención web: una página de texto plano en la raíz del sitio que le cuenta a una IA todo lo que necesita sobre un producto.

https://wontopos.com/llms.txt

Ponlo en tu IDE o agente de código y sabrá cómo construir sobre WOS: auth, endpoints, patrones, errores. Se actualiza con cada release.

Los mismos hechos que la spec OpenAPI, distinta audiencia: la spec es estructura precisa para herramientas; este archivo es prosa que una IA (o una persona) lee de una pasada. Ambos se actualizan con cada release.