Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- envio_de_alertas [2024/09/19 18:44] – utilização de https, novo endpoint para refresh-token luiz.amaral
+++ envio_de_alertas [2025/09/03 14:25] (atual) – guilherme.bassan
@@ Linha 8: / Linha 8: @@
 ''resposta = request(method="POST", url=url, headers=headers, data=payload, verify=False)''
+===== Aviso =====
+Será realizada uma manutenção na API de recebimento de alertas no dia 03/09/2025, podendo haver instabilidade no sistema das 14h30 às 15h30.
 ===== Autenticação =====
@@ Linha 13: / Linha 16: @@
 Por segurança na comunicação dos equipamentos com o Lote 9 é necessário realizar autenticação. Para isso, usamos o JWT e Bearer Authentication. Para mais informações sobre usuário e senha, favor entrar em contato com a CET que encaminhará a solicitação ao Lote 9.\\
 \\
-Para a autenticação, é necessário informar o usuário e senha, caso as credenciais estejam corretas, um token de acesso e um token de reconexão são devolvidos.
+Para a autenticação, é necessário informar o usuário, a senha e o serial do dispositivo, passando o usuário no campo ''username'', a senha no campo ''password'' e o serial no campo ''client_id''.
+Como exemplo em python, o payload do request fica da seguinte forma:\\
+''payload = f"grant_type=password&username={usuario}&password={senha}&scope=&client_id={serial}&client_secret="''
+Caso as credenciais estejam corretas, um token de acesso e um token de reconexão são devolvidos para o local especificado.
 O token de acesso é utilizado para os endpoints de comunicação e energia e possui um tempo de expiração de 15 minutos.
 O token de reconexão é utilizado para manter a conexão ativa sem a necessidade de um novo login, este token possui um tempo de expiração de 20 minutos e é utilizado no endpoint ''refresh-token''.\\
+\\
+Obs.: Os tokens são únicos para cada local e é de suma importância armazenar os tokens recebidos com segurança.\\
 ===== Reconexão =====
-O endpoint ''refresh-token'' recebe um token de reconexão, checa sua expiração e se estiver válido, retorna um novo token de acesso e um novo token de reconexão.
+O endpoint ''refresh-token'' recebe um token de reconexão, checa sua expiração e se estiver válido, retorna um novo token de acesso e um novo token de reconexão.\\
+\\
+Para evitar que requisições retornem com erro por expiração do token de acesso, é recomendado que a atualização dos tokens seja realizada antes da expiração do token de acesso.
-===== Endpoint de comunicação =====
+===== Endpoint de Comunicação =====
-Todos os equipamentos dos consórcios precisam enviar uma requisição ao lote 9 no intervalo minímo de 5 minutos. Recomendamos que essa requisição seja enviado a cada 2 ou 3 minutos para garantir o processamento no tempo esperado.
-  * Regra: Se não houver o envio desta requisição no tempo determinado, será gerado um alerta de equipamento sem comunicação com o Lote 9.
+O endpoint ''comunicacao'' recebe o número serial e o token de acesso, checa a validade do token e retorna uma indicação do sucesso da requisição.\\
+\\
+O status de comunicação de cada dispositivo expira em 5 minutos. Recomendamos que essa requisição seja enviado a cada 2 ou 3 minutos para garantir o processamento no tempo esperado.
+  * Regra: Se não houver o envio desta requisição no tempo determinado, será gerado um alerta de equipamento sem comunicação com o Lote 9.
 ===== Endpoint de Energia =====
+O endpoint ''energia'' recebe o serial do equipamento, o estado da energia e o token de acesso, checa a validade do token e retorna uma indicação do sucesso da requisição.\\
+\\
 Todos os equipamentos dos consórcios precisam enviar uma requisição ao lote 9 quando da falta de energia comercial (funcionamento por nobreak). Quando houver o retorno de energia comercial, uma requisição também deverá ser enviado.
   * Regra: Na ocasião do envio da falta ou retorno de energia no equipamento, será gerado um alerta.
 ===== Documentação via JSON =====
@@ Linha 38: / Linha 51: @@
   * Para visualizar a estrutura, pode ser usado o software online https://jsonviewer.stack.hu/ colando o json na tab "Text", e observando a estrutura na tab "Viewer".
-{{ :api_alertas_documentacao.zip |}}
+{{ :openapi.zip |}}