Diferenças

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

--- envio_de_alertas [2024/09/20 12:34] – -Adicionada observação de segurança sobre os tokens -Adicionado informações sobre as requisições de comunicação e energia 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, a senha e o id do local, passando o usuário no campo ''username'', a senha no campo ''password'' e o id do local no campo ''client_id''.
+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={id_local}&client_secret="''
+''payload = f"grant_type=password&username={usuario}&password={senha}&scope=&client_id={serial}&client_secret="''
@@ Linha 32: / Linha 35: @@
 ===== Endpoint de Comunicação =====
-O endpoint ''comunicacao'' recebe o id do local e o token de acesso, checa a validade do token e retorna uma indicação do sucesso da requisição.\\
+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.\\
 \\
-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.
+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 id do local, o estado da energia e o token de acesso, checa a validade do token e retorna uma indicação do sucesso da requisição.\\
+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.
@@ Linha 48: / 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 |}}