Como funciona a autenticação

Para utilizar os endpoints da nossa API, é necessário incluir um bearer token válido no header Authorization das requisições HTTP.

O fluxo de autenticação funciona da seguinte forma:

Access Token do provedor → /authenticate → Bearer Token → Authorization: Bearer {token}

O access token é um token único, fornecido a cada provedor, utilizado para solicitar a autenticação junto ao endpoint /authenticate. A partir dele, é gerado um bearer token com validade limitada de 6 horas.

O bearer token retornado deve ser enviado no header Authorization de todas as requisições aos endpoints protegidos, utilizando o esquema Bearer:

Authorization: Bearer {token}

Quando o bearer token expira, as requisições aos endpoints protegidos passam a retornar erro de autenticação (401 Unauthorized), sendo necessário solicitar um novo token através do /authenticate.

Mais detalhes técnicos sobre o endpoint /authenticate — parâmetros, formato da resposta e exemplos de uso — estão disponíveis na página Autenticação e na seção Referência.