post https://example.com/Login
Regras de negócio
O procedimento de autenticação é realizado utilizando o usuário e senha válidos e vinculado ao SankhyaID, e deve ser o primeiro passo em uma sessão de chamadas de serviços. Com uma autenticação é possível chamar outros serviços em sequência, como por exemplo os serviços loadrecords e saverecords. Isso porque o bearer token obtido a partir dessa requisição é que deverá ser informado no cabeçalho das chamadas subsequentes, permite que a sessão fique aberta pelo período definido no sistema, que por padrão são 30 minutos de inatividade.
Para alterar o tempo de expiração do bearer token acesse a tela Preferências no SankhyaOM e altere o parâmetro INATSESSTIMEOUT, que pode varia de 1 à 30 minutos.
Atenção: A URL para o login é específica e diferente das demais requisições: https://api.sankhya.com.br/login
No entanto, é fortemente recomendado realizar logoff após realizar as requisições desejadas. Veja a seguir um fluxo de integração recomendado:
- login
- requisição 1
- requisição 2
- requisição N
- logout
Dependências
- O Token é gerado na tela Configurações Gateway do SankhyaOm que deseja realizar a integração.
Detalhes Técnicos:
Corpo de requisição para realizar login
{
curl --location --request POST 'https://api.sankhya.com.br/login' \
--header 'token: 8fedf240-ea7f-11ed-a05b-0242ac120003' \
--header 'appkey: db654b42-ea7f-11ed-a05b-0242ac120003' \
--header 'username: [email protected]' \
--header 'password: *******' \
--data-raw '
}
Retorno em json:
{
"bearerToken": "bearerToken_da_sessao_ativa_retorna_bem_aqui",
"error": null
}
Corpo de requisição para realizar logout
{
curl --location 'https://api.sankhya.com.br/gateway/v1/mge/service.sbr?serviceName=MobileLoginSP.logout&outputType=json' \
--header 'appkey: db654b42-ea7f-11ed-a05b-0242ac120003' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bearerToken_da_sessao_ativa_enviado_bem_aqui'
}
Retorno em json:
{
"serviceName": "MobileLoginSP.logout",
"status": "1",
"pendingPrinting": "false",
"transactionId": "F35F4D5A07D74B06C86301D00E897ADC",
"responseBody": {}
}
Recipes
🦉
API Gateway - Login
Open Recipe
🦉
API Gateway - Logout
Open Recipe