Docs·Auth & chaves API
🔑

Auth & chaves API

Tokens bearer, rotação de chaves, allowlist de IP e erros que você verá quando a auth falhar.

Tokens bearer

Toda requisição para https://api.eveses.com carrega uma chave API como token bearer:

Authorization: Bearer 17|aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd

As chaves são criadas em Account → API Keys. Trate-as como senhas — dão acesso total a saldo, ativações e aluguéis.

Criar

Clique New key, dê um label (local-dev, ci, production-eu). O token é mostrado uma vez na criação — guarde imediatamente.

Rotacionar

Chaves não são editáveis. Para rotacionar: crie uma nova → troque no deploy → exclua a antiga. A exclusão é imediata.

IP allowlist

Allowlist por chave: amarre uma chave a IPs / faixas CIDR específicas. Requisições fora da lista recebem 403. Configuração na página de detalhe da chave.

Scopes

Todas as chaves dão acesso total atualmente. Chaves por scope (read-only, rentals-only) estão no roadmap.

Erros

HTTP Significado
401 Authorization ausente ou malformado
403 Chave revogada, conta suspensa, ou IP fora da allowlist
429 Rate limit por chave excedido (padrão 60 rpm)