Autenticação

Use chaves de API para autenticar requisições de API

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