Autenticação
Mande sua chave no cabeçalho Authorization:
Mande sua chave no cabeçalho Authorization:
Authorization: Bearer salos_sk_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXAceitamos também estas duas formas, por conveniência:
Authorization: salos_sk_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXX-API-Key: salos_sk_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXPor que três formas? Algumas ferramentas de automação já colocam a palavra
Bearersozinhas, e digitar de novo produzBearer Bearer sua_chave— um erro sem pista nenhuma. Aceitando a chave pura, colar direto sempre funciona.
Detalhes que evitam dor de cabeça:
- Se os dois cabeçalhos vierem preenchidos,
Authorizationvence.X-API-Keysó é lido quandoAuthorizationestá ausente. - Espaços e quebras de linha nas pontas da chave são removidos automaticamente.
- O prefixo
salos_sk_live_faz parte da chave. Ele não é decorativo: existe para que ferramentas de varredura de segredo (como as do GitHub) reconheçam uma chave vazada pelo formato. Mande sempre a chave completa. - Cada chave pertence a uma conta. Tudo que ela lê ou escreve fica automaticamente restrito a essa conta — não existe parâmetro de conta na URL.
Dois erros diferentes, de propósito
| Situação | Resposta |
|---|---|
Cabeçalho ausente, vazio, ou só Bearer sem a chave |
401 — "Chave de API ausente." |
| Chave preenchida, mas inválida ou revogada | 401 — "Chave inválida ou revogada." |
Se você recebeu a primeira mensagem, o problema é o cabeçalho não estar chegando (nome errado, ferramenta que não envia). Se recebeu a segunda, o cabeçalho chegou e a chave é que não serve.