Auth Sign-in | Dadosfera Maestro API

Rota de autenticação principal

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Sign In

Rota de autenticação na Dadosfera.

Como utilizar

Utilize seu nome de usuário (username) e senha (password) para gerar um token de acesso que será utilizado em todas as rotas da API. Se você ativou a Autenticação em dois fatores, é necessário enviar o código gerado pelo seu aplicativo no parâmetro totp.

Propriedades da Resposta

O objeto tokens da resposta contém 2 propriedades principais:

  1. accessToken: Token de acesso que contém informações sobre o usuário e suas permissões. Utilize-o no Header das próximas requisições para fazer requests autenticadas.
  2. refreshToken : Token utilizado para renovar o accessToken. Para mais detalhes acesse a documentação da rota /auth/refresh-access-token

O objeto customer contém informações do seu ambiente como id, nome, tier e módulos contratados.

O objeto user contém algumas informações sobre o usuário autenticado.

Expiração 🕑

O token de acesso expira em 30 minutos por padrão. Após esse período é necessário renová-lo.

Body Params
string
required
string
required
string

TOTP code used to login when Multi-Factor Authentication is enabled

Headers
string
enum
Allowed:
Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json