Mudanças entre as edições de "Manuais:ERP.Net/API/Auth"
(Criou página com '<big>'''Realizando autenticação na API'''</big> 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 [htt...') |
(→Acessando a API) |
||
| Linha 6: | Linha 6: | ||
==Acessando a API== | ==Acessando a API== | ||
| − | + | <div class="center"> | |
| − | <table style="border: 1px solid black;border-collapse: collapse;"> | + | <table style="border: 1px solid black;border-collapse: collapse;width: 800px;"> |
<tr style="border: 1px solid black;"> | <tr style="border: 1px solid black;"> | ||
<td style="text-align: center;padding: 7px;border: 1px solid black;">Endpoint</td> | <td style="text-align: center;padding: 7px;border: 1px solid black;">Endpoint</td> | ||
| − | <td style="border: 1px solid black;">https://erpnet.online/api/auth/login</td> | + | <td style="text-align: left;border: 1px solid black;">https://erpnet.online/api/auth/login</td> |
</tr> | </tr> | ||
<tr style="border: 1px solid black;"> | <tr style="border: 1px solid black;"> | ||
<td style="text-align: center;padding: 7px;border: 1px solid black;">Método</td> | <td style="text-align: center;padding: 7px;border: 1px solid black;">Método</td> | ||
| − | <td style="border: 1px solid black;">POST</td> | + | <td style="text-align: left;border: 1px solid black;">POST</td> |
</tr> | </tr> | ||
<tr style="border: 1px solid black;"> | <tr style="border: 1px solid black;"> | ||
<td style="text-align: center;padding: 7px;border: 1px solid black;">Body<br/>(JSON)</td> | <td style="text-align: center;padding: 7px;border: 1px solid black;">Body<br/>(JSON)</td> | ||
| − | <td style="border: 1px solid black;"><pre> | + | <td style="text-align: left;border: 1px solid black;"><pre> |
{ | { | ||
"username": "seu e-mail de usuário", | "username": "seu e-mail de usuário", | ||
| Linha 27: | Linha 27: | ||
<tr style="border: 1px solid black;"> | <tr style="border: 1px solid black;"> | ||
<td style="text-align: center;padding: 7px;border: 1px solid black;">Retorno<br/>(COOKIE)</td> | <td style="text-align: center;padding: 7px;border: 1px solid black;">Retorno<br/>(COOKIE)</td> | ||
| − | <td style="border: 1px solid black;"><pre>{ | + | <td style="text-align: left;border: 1px solid black;"><pre>{ |
"Data": "\"\\u0088\\u0001\\u0002\\u0000x (\u0002[\ufffd\\\\ϡ+\ufffd\\u0018\ufd)\ufffdIi\ufffd\ufffdj\uddddd\ufffd\\ | "Data": "\"\\u0088\\u0001\\u0002\\u0000x (\u0002[\ufffd\\\\ϡ+\ufffd\\u0018\ufd)\ufffdIi\ufffd\ufffdj\uddddd\ufffd\\ | ||
u0004\ufffd+\ufffd.|\ufffd05X\ufffd\ufffdV\\u0014\ufffd\u0002\"", | u0004\ufffd+\ufffd.|\ufffd05X\ufffd\ufffdV\\u0014\ufffd\u0002\"", | ||
| Linha 38: | Linha 38: | ||
</tr> | </tr> | ||
</table> | </table> | ||
| + | </div> | ||
<div class="center">[[Arquivo:Manuais_ERPNet_API_Requisicao_Login.png]]</div> | <div class="center">[[Arquivo:Manuais_ERPNet_API_Requisicao_Login.png]]</div> | ||
| − | Verifique o ''StatusCode'' da resposta. Caso não seja o código 200, 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 | + | 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. | ||
<div class="center">[[Arquivo:Manuais_ERPNet_Cadastro_Pessoa_Usuario_NivelAcesso.png]]</div> | <div class="center">[[Arquivo:Manuais_ERPNet_Cadastro_Pessoa_Usuario_NivelAcesso.png]]</div> | ||
Edição das 00h13min de 16 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": "\"\\u0088\\u0001\\u0002\\u0000x (\u0002[\ufffd\\\\ϡ+\ufffd\\u0018\ufd)\ufffdIi\ufffd\ufffdj\uddddd\ufffd\\
u0004\ufffd+\ufffd.|\ufffd05X\ufffd\ufffdV\\u0014\ufffd\u0002\"",
"Message": "",
"Success": true,
"StatusCode": 200
}
Neste retorno é gerado um cookie que deverá ser passado entre as requisições. Veja na imagem de exemplo uma requisição realizada utilizando a ferramenta Postman |
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.
