API AutoConsulta
API AutoConsulta
Uma chave, um POST, um resultado.
Code
O que dá para fazer
| Você quer | Use |
|---|---|
| Executar uma consulta | POST / |
| Saber quanto vai custar, antes | POST /estimate |
| Ver o que sua conta pode consultar | GET /catalog |
| Ver seu saldo | GET /balance |
| Acompanhar uma consulta demorada | GET /status |
| Recuperar algo que você já consultou | GET /lookup |
Cada uma está descrita, com os campos e os exemplos, na Referência da API.
Três coisas que economizam tempo
1. Confira success, não só o status HTTP. Alguns desfechos de falha chegam com HTTP 200 e
success: false. É o campo success que diz se deu certo, e o code que diz o quê. Ramifique no
code — ele é estável; o texto da mensagem não é.
2. O saldo da carteira é o limite. Não há cota, franquia nem teto além dele.
3. O catálogo é a fonte, não esta página. Preço e disponibilidade variam por conta.
GET /catalog devolve o preço efetivo da sua conta e o contrato de entrada de cada produto —
consulte-o em tempo de execução em vez de fixar valores no seu código.
Antes de gastar
POST /estimate responde quanto custaria, de onde o pagamento sairia, se a entrada está completa e
se aquele documento já está no seu histórico. Não cobra e não executa nada.
Se já estiver no histórico, GET /lookup traz o resultado de novo — também sem cobrar.
Sem escrever código: o servidor MCP
Além da API HTTP, a AutoConsulta expõe um servidor MCP (Model Context Protocol). Você o conecta ao seu cliente MCP e passa a consultar conversando — mesmas consultas, mesmos preços, mesma carteira.
Code
Veja o que é o MCP e como conectar.