◼️ 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

×