Autenticação

POST 
/v1/autenticacao

Realiza a autenticação para obtenção de token. O token recebido deve ser utilizado no header das demais operações através da chave "Authorization".

Esta rota é fornecida pela dependência insoft-api-security; o contrato de resposta deve ser confirmado com insoft-auth na instalação. Envie Authorization: Bearer <token> nas operações protegidas.

Request

application/json

Body

Body

required

credenciais

Substitua pelas credenciais da instalação

{
  "usuario": "USUARIO_API",
  "senha": "SENHA_EXEMPLO"
}

Responses

200

Sucesso

application/json

Schema

Schema

property name* any

Example (from schema)

{}

ilustrativo

Formato legado; TTL e atributos variam conforme instalação

{
  "timeToLive": 345600,
  "permissoes": {},
  "nome": "USUARIO DE TESTES",
  "metodoAutenticacao": {},
  "login": "USUARIO_API",
  "dataCriacao": 1619531538041,
  "email": "Sem e-mail",
  "token": "<TOKEN_RETORNADO_PELA_AUTENTICACAO>"
}

400

Parametros invalidos

application/json

Schema

Schema

property name* any

Example (from schema)

{}

Example

{
  "success": false,
  "message": "Parâmetros inválidos."
}

401

Nao autorizado

application/json

Schema

Schema

property name* any

Example (from schema)

{}

Example

{
  "success": false,
  "message": "Usuário ou senha incorretos."
}

500

Erro interno

application/json

Schema

Schema

property name* any

Example (from schema)

{}

Example

{
  "success": false,
  "message": "Erro ao autenticar."
}

Loading...