API & MCP

Autenticação

Toda requisição leva a sua chave no cabeçalho Authorization, no formato Bearer. Cada conta tem duas chaves, geradas e revogadas em API e cobertura:

• Chave viva, ilz_ seguida de 48 caracteres. É do plano Máquina, R$ 97 por mês: cota, grava propostas e lê /v1/proposals. Para gerar, a conta precisa ter o plano e as condições comerciais confirmadas (a tela pede, porque a API emite proposta em nome da sua empresa).
• Chave de teste, ilz_test_ seguida de 48 caracteres. Vale em qualquer plano, inclusive no Grátis: cota em modo simulação e lê a cobertura; não grava nem lê propostas. A cota é de 50 por dia na conta, somando as requisições REST e as chamadas de ferramenta do MCP; conectar e listar as ferramentas não gasta. A cota volta à meia-noite de Brasília.

Authorization: Bearer ilz_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

• Cada chave aparece uma única vez, na criação. Guarde em variável de ambiente ou num cofre de segredos.
• Guardamos só o hash (SHA-256): não dá para recuperar a chave. Perdeu, gere outra.
• Gerar de novo troca a chave: a anterior para de valer na hora, e o site, o CRM ou o agente que usam a antiga passam a receber 401. As duas chaves são independentes: trocar a de teste não mexe na viva.
• Envie a chave somente no cabeçalho Authorization. Nunca em query string (?key=), que vaza em logs e no histórico.
• A chave é da sua conta: a cotação usa os seus kits, a sua formação de preço e o seu perfil.