Skip to main content
POST
Obter token de acesso

Como autenticar

Siga os passos abaixo para obter e usar o token de acesso OAuth 2.0:
1

Obter credenciais de cliente

Você precisa ter credenciais de cliente válidas (client_id e client_secret) fornecidas pela Husky.Entre em contato com o suporte para obter suas credenciais se ainda não as possui.
2

Fazer requisição POST para obter o token

Faça uma requisição POST para este endpoint. Ler Parâmetros esperados mais abaixo.
3

Receber o token de acesso

A resposta retornará um objeto JSON com o token de acesso. O token tem validade de 7 dias (604800 segundos).
A duração da validade pode ser alterada a qualquer momento, é preciso que sua integração esteja preparada para renovar token em caso de retorno como não autorizado.
4

Usar o token nas requisições

O token retornado deve ser usado no header Authorization de todas as requisições subsequentes:
Todos os endpoints protegidos requerem este token no header.
5

Renovar o token quando expirar

Quando o token expirar, você precisará obter um novo token usando este mesmo endpoint.
Se você receber um erro 401 Unauthorized, verifique se o token não expirou e obtenha um novo token.

Body

application/x-www-form-urlencoded
grant_type
enum<string>
required

Tipo de concessão OAuth. Deve ser sempre "client_credentials"

Available options:
client_credentials
Example:

"client_credentials"

client_id
string
required

Identificador único do cliente

Example:

"123e4567-e89b-12d3-a456-426614174000"

client_secret
string<password>
required

Segredo do cliente

Example:

"sua-chave-secreta-aqui"

Response

Token de acesso obtido com sucesso

access_token
string
required

Token de acesso OAuth 2.0 que deve ser usado para autenticar requisições subsequentes

Example:

"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIjoi..."

token_type
enum<string>
required

Tipo do token, sempre "Bearer"

Available options:
Bearer
Example:

"Bearer"

expires_in
integer
required

Tempo de expiração do token em segundos (7 dias = 604800 segundos)

Example:

604800