Skip to main content
Toda integração começa por aqui. Envie as credenciais do usuário de integração cadastrado no Gestio e receba o accessToken a ser usado no header Authorization das demais chamadas.

​
Autenticar

Use POST /v2/autenticar. Não requer autenticação prévia — esta é a rota que gera o token.

Campos obrigatórios

email e password do usuário de integração cadastrado no Gestio.
Exemplo:
Resposta (sucesso):
Esta rota sempre responde com HTTP 200, mesmo quando email/password estão incorretos. Verifique o campo authenticated no corpo da resposta para saber se a autenticação foi bem-sucedida.
Resposta (falha):

​
Usando o token

O token retornado deve ser enviado no header Authorization de todas as demais requisições, no formato Bearer {token}:
Tokens expiram após um período determinado. Se receber 401 em outra rota, gere um novo token por aqui antes de repetir a chamada.
Nunca exponha email/password de integração em código client-side (frontend, apps mobile). Essa chamada deve ser feita apenas pelo seu backend.