Skip to main content

Autenticação via Login e Senha

Por padrão, é utilizada a autenticação JWT (JSON Web Tokens) para consumo dos endpoints protegidos.

A geração desse token de acesso é através do endpoint /auth/api/token/. O mesmo é obtido através de uma requisição POST passando o email e senha de acesso.

O email e senha de acesso, são disponibilizados após credenciamento do fornecedor na plataforma Cotabest.

Confira as instruções de como obter seu token de acesso logo abaixo.

Iniciando uma autenticação​

Altere o método da requisição para o tipo POST.

auth1

Configurando a URL da requisição​

Nesse caso, devemos configurar a URL no endpoint /auth/api/token/

auth2

Configurando os headers da sessão​

É necessário adicionar o campo Content-Type com o valor application/json.

auth3

Configurando os parâmetros do corpo da requisição​

Insira os dados de acesso (email e senha Cotabest) no campo Body>raw e clique em Send para gerar seu token de acesso. Segue o exemplo do modelo que os dados devem ser enviados:

{
    "email": "seuemail@mail.com",
    "password": "suasenha"
}

Observação de cada campo e os tipos de dados aceitos em cada um:

CAMPOTIPOOBSERVAÇÃO
emailstring
passwordstring

auth4

Token de acesso para usar em outras requisições​

O token de autorização é recebido no campo access. O token recebido no campo refresh pode ser utilizado no endpoint de refresh token. Confira aqui como utilizar o Refresh Token.

auth5