Mudanças entre as edições de "Manuais:ERP.Net/API/Auth"
(→Acessando a API) |
|||
| Linha 43: | Linha 43: | ||
<center>'''<span style="color: red;">ATENÇÃO</span>'''</center> | <center>'''<span style="color: red;">ATENÇÃO</span>'''</center> | ||
| − | Cada linguagem de programação trata o cookie de forma diferente. Atente-se para a forma como a linguagem de desenvolvimento escolhida por você trata o cookie. | + | Cada linguagem de programação trata o cookie de forma diferente. Atente-se para a forma como a linguagem de desenvolvimento escolhida por você trata o cookie. Pode ser no ''HEADER'' ou diretamente pela coleção ''COOKIES''<br/> |
| − | O cookie que é retornado no objeto de resposta deverá ser passado durante as requisições. Como HEADER ou pela coleção COOKIES, dependendo da linguagem de desenvolvimento escolhida. | + | O cookie que é retornado no objeto de resposta deverá ser passado durante as requisições. Como ''HEADER'' ou pela coleção ''COOKIES'', dependendo da linguagem de desenvolvimento escolhida. |
<div class="center">[[Arquivo:Manuais_ERPNet_API_Requisicao_Login.png]]</div> | <div class="center">[[Arquivo:Manuais_ERPNet_API_Requisicao_Login.png]]</div> | ||
Edição das 09h54min de 17 de maio de 2018
Realizando autenticação na API
Para utilizar o serviço de APIs do ERP.Net é necessário ter uma conta criada em nosso sistema de gestão em nuvem. o ERP.Net.
Para criar a sua conta, entre em contato com o nosso comercial pelo e-mail [email protected]
Acessando a API
| Endpoint | https://erpnet.online/api/auth/login |
| Método | POST |
| Body (JSON) |
{
"username": "seu e-mail de usuário",
"password": "sua senha"
}
|
| Retorno (COOKIE) |
{
"Data": null,
"Message": "",
"Success": true,
"StatusCode": 200
}
Neste retorno é gerado um COOKIE que deverá ser recuperado e ser passado entre as requisições. Veja na imagem de exemplo uma requisição realizada utilizando a ferramenta Postman |
Cada linguagem de programação trata o cookie de forma diferente. Atente-se para a forma como a linguagem de desenvolvimento escolhida por você trata o cookie. Pode ser no HEADER ou diretamente pela coleção COOKIES
O cookie que é retornado no objeto de resposta deverá ser passado durante as requisições. Como HEADER ou pela coleção COOKIES, dependendo da linguagem de desenvolvimento escolhida.
Verifique o StatusCode da resposta ou a propriedade 'Success. Caso não seja o código 200 ou true, houve um erro na requisição.
Na maioria dos casos o erro é o 401 (Não Autorizado).
Verifique junto ao suporte se sua conta já foi criada, se já estiver sido criada, peça ao seu departamento de TI para que faça a alteração do usuário para que seja permitido acesso na API do ERP.Net.
Veja na imagem de exemplo onde deverá ser alterado para permitir acesso à API.
