Autenticação e chaves
Envie a chave somente no cabeçalho:
Authorization: Bearer odj_live_ab12cd34ef_<segredo>
Credenciais na query string são recusadas (400).
Formato e armazenamento
odj_<ambiente>_<prefixo>_<segredo>: o prefixo identifica a chave no portal; o segredo tem 256 bits.- A odjud guarda apenas o HMAC-SHA256 do segredo (com chave externa ao banco). Ninguém consegue recuperar a chave depois de criada: se perder, gere outra.
Escopos
| Escopo | Permite |
|---|---|
searches:write |
criar e cancelar buscas |
searches:read |
listar e ler buscas e resultados |
processes:read |
ler processos já entregues |
monitorings:write / monitorings:read |
gerenciar/listar monitoramentos |
account:read |
saldo, extrato, uso, limites e faturas |
billing:write |
criar recargas (somente chave live) |
Rotação sem indisponibilidade
No portal, Rotacionar cria uma chave nova com os mesmos escopos e mantém a anterior válida por 24 horas. Troque nos seus servidores e revogue a antiga. Revogação é imediata.
Criação de chaves e webhooks
Somente pelo portal autenticado (sessão com cookie seguro e CSRF). Não há endpoint público para criar chaves.
Boas práticas
- Uma chave por aplicação e ambiente; escopo mínimo.
- Defina expiração para chaves temporárias.
- Nunca use a chave no navegador do usuário final.