Começar
Autenticação
Como a API key identifica a marca e como a conta escolhe o cliente final.
Há dois dados em quase toda chamada de negócio: quem é o integrador e de qual conta é o dado.
Chave zera_live_ da marca. Também vale Authorization: Bearer com o mesmo valor.
UUID da conta do cliente final. Obrigatório em veículo, consulta e pedido.
API key
A chave identifica a marca (label) do parceiro. Ela tem o prefixo zera_live_ e pode ir de dois jeitos:
X-Api-Key: zera_live_...Authorization: Bearer zera_live_...Use um dos dois. Chave ausente, revogada ou de marca inativa responde 401 com {"detail":"API key inválida ou revogada."}.
A chave é da marca, não de um usuário humano. Com ela, a Zera associa a chamada ao tenant e à label donos da key.
Conta
Veículos, consultas e pedidos pertencem a uma conta. Informe o UUID no header:
X-Account-Id: 4b6e0c2a-1d4f-4a8b-9c3e-1a2b3c4d5e6fA conta precisa existir, estar ativa e pertencer à mesma marca da API key. Sem o header, essas rotas não têm contexto e a chamada falha. GET /api/v1/coverage e GET /health não usam conta.
O que não vai neste header
Sessão JWT, cookie de refresh e 2FA pertencem ao aplicativo Zera. Uma integração servidor-a-servidor usa API key + conta. Fluxos de login de usuário final ficam para uma etapa posterior da documentação.
Revogação
Revogar a chave no portal invalida as chamadas na hora. Gere outra key e troque o segredo no seu backend antes de revogar a antiga, se a integração não puder parar.