Autenticação

Como autenticar requisições com chaves de API.

Envie a chave de API no cabeçalho Authorization como Bearer token. Todas as rotas /v1 exigem autenticação. O prefixo define o ambiente:

Prefixo	Ambiente	Efeito
`sk_test_`	Teste	Dados e saldo simulados.
`sk_live_`	Produção	Dinheiro real. Exige conta aprovada.

Requisição autenticada

curl "https://api.pombopix.com/v1/balance" \
  -H "Authorization: Bearer sk_test_..."

Gerenciar chaves

Crie e revogue chaves no painel, em Desenvolvedores, na tela Chaves de API. A chave completa aparece uma única vez.
Guardamos apenas o hash. Se perder a chave, revogue e crie outra.
A revogação vale na hora para todas as requisições seguintes.

Falhas de autenticação

Chave ausente, inválida ou revogada devolve 401 unauthorized. Conta em análise usando chave de produção devolve 403 account_not_active nas operações de cobrança e saque.

401

{
  "error": {
    "code": "unauthorized",
    "message": "Chave de API ausente ou inválida."
  }
}