===== Envio de Alertas =====

O objetivo é o envio de alertas de comunicação e de energia.

Este módulo contem endpoints para o envio de informações ao Lote 9.

A conexão é realizada por https, com um certificado gerado pelo próprio Lote 09, ou seja, não é verificado por uma autoridade de certificação (CA), o que significa que na implementação é preciso desativar essa verificação. Como exemplo em python, utilizando a biblioteca ''requests'', é preciso desativar a flag ''verify'':

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

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 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.\\
\\
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 =====

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 =====
Pata facilitar o entendimento dos desenvolvedores dos consórcios, segue um json com os endpoints. 
  * 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".

{{ :openapi.zip |}}