Manual da API de geração de Token

• Introdução
• Acesso
• Autenticação
• Descrição dos campos de retorno

Introdução

A API autenticação bearer token faz parte do processo de autenticação de outras soluções da Systax, gerando um token em função das credenciais informadas pelo cliente. O token gerado tem um tempo de vida de 60 minutos, e após, a aplicação do cliente terá que autenticar novamente e obter um novo token. Antes do tempo de expiração, contudo, é possível revalidar um token. 

Acesso

Swagger:

https://app.systax.com.br/auth/swagger#/

API  de criação de token:

Método: GET
API Rest / JSON: https://app.systax.com.br/auth/access-token

 

API de revalidação de token:

Método: GET
API Rest / JSON: https://app.systax.com.br/auth/refresh-token

Observação: Essa API só faz a revalidação de um token vigente.

Autenticação

Para se autenticar na API de criação de token é necessário informar usuário e senha válidos via recurso "Basic Authentication". Para fins de homologação, usar as seguintes credenciais: usuário: superdemo.ws e senha: systax741

 

Para revalidar um token vigente utiliza-se o recurso de autenticação "BearerToken": 

Descrição dos campos de retorno

 

Campo	Descrição	Tipo
success	Status do retorno	boolean
status	Mensagem do retorno	string
token	Token	string
expires_in	Tempo de expiração	numeric

 

Tabela de referência do campo "success" e "status" (API de criação de token)

Código de retorno	success	status
200	True	OK
400	false	Authorization incorreto ou invalido
401	false	Não autorizado

 

Tabela de referência do campo "success" e "message" (API de revalidação de token)

Código de retorno	success	status
200	True	OK
400	false	token_expired missing_token token_invalid
401	false	Token não enviado ou dados inválidos