Autenticação
A autenticação consiste em obter um token temporário que servirá como identificador
para os pedidos seguintes.
POST https://segurosapi.libax.com/v1/authenticate
Permissão requerida: leitura e/ou escrita
Parâmetro
|
|
Descrição
|
Username *
|
string
|
E-mail que utiliza para entrar no Libax Seguros
|
Password *
|
string
|
Palavra-passe que utiliza para entrar no Libax Seguros
|
AgentID *
|
int
|
Fornecido pelo agente. Identificação do agente que pretende realizar a ligação.
Ex: 3501
Pode saber este Id olhando para o endereço que aparece na barra de endereços quando
entra normalmente no Libax Seguros.
|
Expires
|
int
|
O valor mínimo é 1 e o máximo é 90 minutos. Se não enviado ou fora do intervalo autorizado,
é considerado 1 minuto. O token expira após este limite caso não haja atividade.
|
* obrigatórios
Permissões revalidadas a cada 2 horas
Se for pedido novo token para um user com token ativo para um agentId, será concedido novo token mas o anterior ficará expirado.
A contagem de tempo para limite de requests por minutos será mantida.
Respostas
HTTP: 200
{ "Token": "79c58e1db7bc48f7b08bf384249bae31", "Expires": 1 }
HTTP: 404, caso o agente não exista
{ "Message": "Agent not found" }
HTTP: 401, porque enviou password inválida
{ "Message": "Access denied" }
HTTP: 403, caso o agente tenha a conta suspensa
{ "Message": "Agent suspended" }
HTTP: 403, porque alcançou o número de tentativas
{ "Message": "Locked. Must wait x minutes" }