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 um exemplo de cada código, os cabeçalhos de limite e os eventos de webhook (lead.criado, proposta.aberta, proposta.aceita e ping).

# 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 sai do mesmo código da API: um teste falha se um código de erro ou um campo aceito no pedido ficar de fora, e se a resposta da cotação mudar de forma sem o documento acompanhar. Os exemplos de pedido e de resposta são os mesmos deste manual, calculados pelo motor da cotação e conferidos contra a API.

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