Autenticação

Token JWT

A autenticação nas APIs do mostQI usa o padrão JWT, que garante uma camada de segurança para a sua operação.

Para obter o token, envie uma requisição para a rota Authenticate (Get JWT) com a sua client key no corpo. O token retornado autentica a chamada a qualquer outro serviço do mostQI.

Como o token funciona

Para reduzir riscos de segurança e de interceptação, os tokens são únicos e temporários:

Uso único: cada token autoriza uma única requisição.

Validade: o token expira 10 minutos após ser emitido. Se não for usado nesse intervalo, expira automaticamente.

Um token por chamada: gere um novo token para cada chamada que o seu sistema fizer aos serviços do mostQI.

Como enviar o token

Envie o token no cabeçalho Authorization de cada requisição, no formato Bearer:

Um token inválido, expirado ou já usado retorna o erro R117 (HTTP 401). Veja a lista completa em Mensagens de Erro.

Fluxo de integração

O diagrama mostra como o seu backend deve interagir com o mostQI para autenticar e consumir os serviços:

Segurança

As requisições passam por um WAF (Web Application Firewall), que avalia o comportamento das aplicações que consomem os serviços.

Authentication

Autenticação#

Token JWT#

Como o token funciona#

Como enviar o token#