Chaves de API: criar e proteger

Com uma chave de API o seu sistema (ou um desenvolvedor contratado) lê e grava dados do App do MEI pela API REST em https://appdomei.com/api/public/v1. Planos Pro e Negócio têm até 10 chaves com todos os escopos; o Grátis pode criar 1 chave só de leitura.

Criar

1. Mais → Integrações → Chaves de API → Nova chave.
2. Dê um nome que diga onde a chave vai ser usada ("Site da loja", "Planilha do contador").
3. Marque só os escopos necessários: invoices:read para consultar cobranças, contacts:write para criar contatos… Menos é mais.
4. Opcional: limite por minuto e lista de IPs permitidos (se o seu sistema tem IP fixo).
5. Salve e copie a chave adm_live_… agora — ela é mostrada uma única vez. Depois só aparece o prefixo.

Usar

Envie em todo pedido o cabeçalho Authorization: Bearer adm_live_…. Respostas em JSON; erros em inglês por padrão (Accept-Language: pt-BR traduz). Em criações, mande Idempotency-Key para poder repetir o pedido com segurança. Referência completa, exemplos em curl e limites em /desenvolvedores.

Proteger

• Guarde a chave em variável de ambiente ou cofre de segredos — nunca no código, em planilha compartilhada ou em app de celular/JavaScript do navegador.
• Uma chave por sistema: se um vazar, você revoga só aquele.
• Acompanhe o uso na lista de chaves (última utilização, IP, total de pedidos).
• A chave herda as suas permissões; um membro da equipe com papel limitado gera chaves igualmente limitadas.

Se vazar

Toque em Revogar na hora: a chave para de funcionar imediatamente. Crie outra e atualize o seu sistema. Confira a auditoria da conta para ver o que foi feito.

API ou webhook?

A API responde ao que você pergunta; o webhook avisa quando algo acontece. Muitos sistemas usam os dois: recebem o invoice.paid pelo webhook e, se precisarem de mais detalhes, consultam a API. Veja Webhooks.