API & MCP

OpenAPI

A especificação completa, em OpenAPI 3.1, fica em https://app.ionluz.com.br/api/v1/openapi.json. É pública, dispensa chave e traz os quatro endpoints, o catálogo de erros com exemplo de cada código, os headers de limite e os três eventos de webhook.

# Postman e Insomnia: File > Import > Link, e cole a URL
# gerar um cliente:
npx @openapitools/openapi-generator-cli generate \
  -i https://app.ionluz.com.br/api/v1/openapi.json -g typescript-fetch -o ./ionluz-client

O documento é gerado a partir do próprio código da API, com um teste que falha se um erro novo ou um campo novo ficar sem documentação. Se o spec diz que existe, existe.

Para agentes: o agent-card.json descreve as habilidades do servidor MCP em /.well-known/agent-card.json.