Autenticação

Mande sua chave no cabeçalho Authorization:

Mande sua chave no cabeçalho Authorization:

Authorization: Bearer salos_sk_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXX

Aceitamos também estas duas formas, por conveniência:

Authorization: salos_sk_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXX
X-API-Key: salos_sk_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXX

Por que três formas? Algumas ferramentas de automação já colocam a palavra Bearer sozinhas, e digitar de novo produz Bearer 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, Authorization vence. X-API-Key só é lido quando Authorization está 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.