Sua primeira cotação via API (e o agente de IA via MCP)

Leitura de 6 min · verificado em 2026-07-23

Você vai conseguir: fazer uma cotação completa por código — e saber onde está a documentação inteira.

1. 1 Gere a sua chave

   Com o Total + API ativo, gere a chave em API. Ela aparece uma vez — guarde num cofre de segredos. Dá pra revogar e gerar outra quando quiser.

2. 2 Faça a primeira cotação

   Uma chamada, orçamento completo de volta:

   curl -X POST https://app.ionluz.com.br/api/v1/quote \
     -H "Authorization: Bearer SUA_CHAVE" \
     -H "Content-Type: application/json" \
     -d '{"consumoKwhMes": 550, "uf": "SP", "cidade": "Campinas", "preview": true}'

   Copiar

   Com preview: true nada é gravado — perfeito pra calculadora do seu site. Sem preview (e com consent: true do titular), o lead é salvo e a resposta traz pdfUrl e propostaUrl prontos.

3. 3 Boas práticas que a API já cobra

   Idempotência por header Idempotency-Key (retry seguro), erros estruturados com código e mensagem, e limites com aviso via headers X-RateLimit-*.

4. 4 Agente de IA via MCP

   O endpoint MCP expõe as ferramentas quote_solar e check_coverage — seu agente conversa com o cliente e cota de verdade. A referência completa está em docs/api.