Spec OpenAPI

O mapa completo e legível por máquina da API - cada endpoint, requisição, resposta e erro.

OpenAPI é o formato padrão da indústria para descrever uma API HTTP em um arquivo legível por máquinas.

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

O que dá para fazer com isso

Postman: File → Import → cole a URL e todos os endpoints viram uma coleção clicável. ChatGPT: crie um GPT, adicione uma Action, cole a mesma URL. Codegen: openapi-generator -i .../openapi.json -g go gera um cliente em uma linguagem que não publicamos.

Importe no Postman, gere um cliente em uma linguagem que não publicamos, conecte ChatGPT Actions ou rode checks de contrato no CI. Um teste a fixa às rotas reais: não há como desviar.

llms.txt

Toda a API em uma página de texto que uma IA consegue ler.

llms.txt é uma convenção da web: uma página de texto puro na raiz do site que conta a uma IA tudo o que ela precisa sobre um produto.

https://wontopos.com/llms.txt

Coloque na sua IDE ou agente de código e ele sabe como construir sobre o WOS - auth, endpoints, padrões, erros. Atualizado a cada release.

Os mesmos fatos da spec OpenAPI, público diferente: a spec é estrutura precisa para ferramentas; este arquivo é prosa que uma IA (ou uma pessoa) lê de uma vez. Ambos atualizam a cada release.