Segurança
Autenticação
Toda chamada leva o seu token de API no cabeçalho Authorization.
Authorization: Bearer prj_live_...Cabeçalhos
| Cabeçalho | Valor | Obrigatório |
|---|---|---|
Authorization | Bearer prj_live_... | Sim |
Accept | application/json | Recomendado |
Content-Type | application/json | Sim, quando a chamada tem corpo (POST) |
Idempotency-Key | um código único por pedido (UUID) | Sim, em Gerar keys |
O token
- Começa com
prj_live_e tem 49 caracteres. - Só vale no cabeçalho
Authorization. Não mande o token no endereço (?token=) nem no corpo. - Pode ter validade (30 dias, 90 dias ou 1 ano) ou não ter. Você escolhe ao criar.
- Cada conta pode ter até 10 tokens ativos.
- Token apagado ou vencido responde
401. Crie outro no painel.
Respostas de autenticação
| HTTP | Quando |
|---|---|
401 | Cabeçalho ausente, token inválido, apagado ou vencido. |
403 | O token é válido, mas não tem a permissão daquela rota. |
{
"success": false,
"message": "Este token não tem permissão para esta ação (precisa de \"keys:generate\").",
"errors": { "required_scope": "keys:generate" }
}Se o token vazar
Apague o token no painel: ele para de funcionar na hora. Depois crie outro e troque no seu servidor. Não compartilhe tokens em repositórios, imagens ou conversas.