Autenticação
A LINK fornece para os integradores um usuário associado a cada garagem. Dessa forma, não é necessário passar como parâmetro nas requisições para qual garagem a requisição deve ser direcionada. Esse controle é feito pelo sistema de automação da LINK e a requisição é direcionada à garagem à qual o usuário autenticado está vinculado.
O serviço de autenticação deve ser realizado somente uma vez a cada ciclo de interação do sistema cliente com os servidores LINK. Não é necessário autenticar o sistema cliente e obter um TOKEN a cada requisição. A autenticação fornece um TOKEN, no formato JWT, com validade de 1 hora, que deve ser utilizado nas requisições subsequentes dos serviços.
POST api/auth/login
HEADERS
CHAVE |
VALOR |
DESCRIÇÃO |
OBRIGATÓRIO |
Accept |
application/vnd.linkc.com.br; version=1 | Versão da API. | SIM |
Authorization |
Basic <email>:<senha> |
Credenciais do usuário fornecidas pela LINK. O valor <email>:<senha> deve estar codificado em Base64. | SIM |
RETORNO EM CASO DE SUCESSO (200 – OK)
CHAVE |
DESCRIÇÃO |
token |
TOKEN gerado pelo sistema. |
exp |
Data e hora de validade do TOKEN |
{
"token": "eyJhbGciOiJIUzI1NiJ9.eyJ1c3VhcmlvX2lkIjoxLCJleHAiOjE1NjcyMTQ0NTR9.8flFqRXCDPzV8rpJc8n61oYFVxMJnU5cCdzgthJSEDU",
"exp": "2019-08-31T01:20:54.000+00:00"
}
OUTROS RETORNOS
CÓDIGO HTTP |
DESCRIÇÃO |
400 |
Caso o parâmetro Authorization esteja em formado diferente da especificação da RFC-7617. |
401 |
Caso as credenciais sejam inválidas. |