◼️ 1. Autenticação
1.1.POST Gerar token de autenticação V1
O objetivo deste método é permitir que o usuário gere o token de autenticação para a API ArqGed.
URL
Entrada
Neste serviço o usuário deve informar o usuário (login) e senha.
• Usuário
• Senha
Request body
“`json
{
“username”: “string”,
“password”: “string”,
“aplicacao”: “string”,
“tempoExpiracao”: 0, //Definição do tempo de expiração do token
“utilizacaoUnica”: “string” //True ou False
}
“`
Por default o token tem validade de expiração de 5 dias, mas o usuário pode definir a expiração em minutos. Além disso, o usuário pode definir se o token é de utilização única através do parametro “utilizacaoUnica”, informando true ou false.
Validações
O sistema valida se o usuário ou senha são válidos.
Saída/Retorno
O sistema retorna um JSON completo com os dados de autenticação do usuário.
Code: 201 – Created
Response
“`json
{
“IdUsuario”: “guid”,
“NomeUsuario”: “string”,
“Login”: “string”,
“Token”: “string”,
“ExpiracaoToken”: “string”,
“RefreshToken”: “string”,
“ExpiracaoRefreshToken”: “string”
}
“`
1.2.POST Atualizar token de autenticação V1
O objetivo deste método é permitir que o usuário atualize o token de autenticação para a API ArqGed.
URL
Entrada
Neste serviço o usuário deve informar o usuário (login), id do usuário e o token para atualização.
• IdUsuário
• username
• Token para atualização
Request body
“`json
{
“idUsuario”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
“username”: “string”,
“refreshToken”: “string”
}
“`
O token de atualização (refreshToken) é retornado no serviço descrito no tópico 1.1.
Validações
O sistema valida se o token de atualização (refreshToken) pertence ao usuário informado.
Saída/Retorno
O sistema retorna um JSON completo com os dados de autenticação do usuário.
Code: 201 – Created
Response
“`json
{
“IdUsuario”: “guid”,
“NomeUsuario”: “string”,
“Login”: “string”,
“Token”: “string”,
“ExpiracaoToken”: “string”,
“RefreshToken”: “string”,
“ExpiracaoRefreshToken”: “string”
}
“`
—
Atualizado há 10 dias