Manuais:ERP.Net/API/Auth - Histórico de revisão

Wesley: Adicionado NOTITLE

2022-07-07T16:47:59Z

Adicionado __NOTITLE__

Marcelo em 16h52min de 5 de julho de 2019

2019-07-05T16:52:20Z

Marcelo: /* Acessando a API */

2018-05-17T12:54:44Z

‎Acessando a API

Marcelo em 12h52min de 17 de maio de 2018

2018-05-17T12:52:25Z

Marcelo: /* Acessando a API */

2018-05-17T02:14:39Z

‎Acessando a API

Marcelo: /* Acessando a API */

2018-05-16T03:13:00Z

‎Acessando a API

Marcelo: Criou página com ''''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 [htt...'

2018-05-15T20:55:09Z

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...'

Página nova

<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 [https://erpnet.online ERP.Net].

Para criar a sua conta, entre em contato com o nosso comercial pelo e-mail <span class="plainlinks">[mailto:comercial@unimake.com.br comercial@unimake.com.br]</span>

==Acessando a API==

<table style="border: 1px solid black;border-collapse: collapse;">
<tr style="border: 1px solid black;">
<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>
</tr>
<tr style="border: 1px solid black;">
<td style="text-align: center;padding: 7px;border: 1px solid black;">Método</td>
<td style="border: 1px solid black;">POST</td>
</tr>
<tr style="border: 1px solid black;">
<td style="text-align: center;padding: 7px;border: 1px solid black;">Body<br/>(JSON)</td>
<td style="border: 1px solid black;"><pre>
{
"username": "seu e-mail de usuário",
"password": "sua senha"
}
</pre></td>
</tr>
<tr style="border: 1px solid black;">
<td style="text-align: center;padding: 7px;border: 1px solid black;">Retorno<br/>(COOKIE)</td>
<td style="border: 1px solid black;"><pre>{
"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
}</pre>

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 [https://www.getpostman.com Postman]</td>
</tr>
</table>

<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

<div class="center">[[Arquivo:Manuais_ERPNet_Cadastro_Pessoa_Usuario_NivelAcesso.png]]</div>

← Edição anterior		Edição das 16h47min de 7 de julho de 2022
Linha 1:		Linha 1:
		+	__NOTITLE__
	<big>'''Realizando autenticação na API'''</big>		<big>'''Realizando autenticação na API'''</big>

@@ Linha 43: / Linha 43: @@
 <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>

@@ Linha 10: / Linha 10: @@
 <tr style="border: 1px solid black;">
 	<td style="text-align: center;padding: 7px;border: 1px solid black;">Endpoint</td>
-	<td style="text-align: left;border: 1px solid black;">https://erpnet.online/api/auth/login</td>
+	<td style="text-align: left;border: 1px solid black;">https://erpnet.online/api/v1.0/auth/login</td>
 </tr>
 <tr style="border: 1px solid black;">

@@ Linha 34: / Linha 34: @@
 }</pre>
-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 [https://www.getpostman.com Postman]</td>
+<span style="color:blue;">Neste retorno '''é gerado um ''COOKIE'' que deverá ser recuperado e ser passado entre as requisições'''. </span>
 </tr>
 </table>
 </div>
 <div class="center">[[Arquivo:Manuais_ERPNet_API_Requisicao_Login.png]]</div>

@@ Linha 28: / Linha 28: @@
 	<td style="text-align: center;padding: 7px;border: 1px solid black;">Retorno<br/>(COOKIE)</td>
 	<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": null,
      "Message": "",
      "Success": true,

@@ Linha 6: / Linha 6: @@
 ==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;">
 	<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 style="border: 1px solid black;">
 	<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 style="border: 1px solid black;">
 	<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",
@@ Linha 27: / Linha 27: @@
 <tr style="border: 1px solid black;">
 	<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\\
 u0004\ufffd+\ufffd.|\ufffd05X\ufffd\ufffdV\\u0014\ufffd\u0002\"",
@@ Linha 38: / Linha 38: @@
 </tr>
 </table>
 <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.
 <div class="center">[[Arquivo:Manuais_ERPNet_Cadastro_Pessoa_Usuario_NivelAcesso.png]]</div>

Manuais:ERP.Net/API/Auth - Histórico de revisão

Wesley: Adicionado __NOTITLE__

Marcelo em 16h52min de 5 de julho de 2019

Marcelo: /* Acessando a API */

Marcelo em 12h52min de 17 de maio de 2018

Marcelo: /* Acessando a API */

Marcelo: /* Acessando a API */

Marcelo: Criou página com ''''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 [htt...'

Wesley: Adicionado NOTITLE