Pular para o conteúdo principal

Autenticação

A API Base39 utiliza chaves de API para autenticar requisições. Use a chave no header Authorization em todas as requisições.

Metódo de autenticação

A Base39 autentica as requisições através do header Authorization. Pode ser Basic ou Bearer. Recomendamos o uso do Basic.

Basic (recomendado)

O Basic Authentication é o sistema de autenticação mais comum do protocolo HTTP. Ele é incluído no header da requisição HTTP dessa maneira:

Authorization: Basic {credenciais em Base64 no formato username:password}
curl https://api.base39.io/v1/customers \
-u bs_sandbox_65592feb50584d6838855f12:

Use a chave de API como username. Não é necessário informar um password.

Lembre que o Base64 é um esquema de codificação e não criptografia. Assim sendo, utilizamos somente com uma conexão HTTPS (TLS).

Bearer

Se você precisa autenticar com Bearer Auth (para uma requisição cross-origin), use nesse formato:

Authorization: Bearer bs_sandbox_65592feb50584d6838855f12
curl https://api.base39.io/v1/customers \
-H "Authorization: Bearer bs_sandbox_65592feb50584d6838855f12"

Guia relacionado: Chaves de API