Dispositivos conectados · API HTTP
Node-RED, Home Assistant ou o seu script integrados à manutenção
Muitas plantas já leem seus medidores em algum lugar: um fluxo Node-RED consultando um analisador Modbus, uma instância Home Assistant com uma dúzia de sensores, um gateway de CLP, um script Python num pequeno PC. O FreeMaint Connect permite que qualquer um deles envie seus valores com uma única requisição HTTP, para que essas medições finalmente cheguem aos ativos, aos alertas e às ordens de serviço.
Free your maintenance · Plano Core gratuito, usuários ilimitados, sem cartão de crédito.
Em resumo
O FreeMaint Connect aceita medições de qualquer sistema capaz de enviar JSON por HTTP: Node-RED, Home Assistant, um gateway Modbus ou de CLP, um roteador Teltonika ou um script. Cada requisição leva uma chave de acesso no cabeçalho e lista dispositivos com seus valores; o FreeMaint converte as unidades, cria os canais na primeira mensagem e deixa regras de alerta, contadores de horas e medidores de energia usá-los como qualquer dispositivo certificado.
Atualizado em 16 de outubro de 2026
O que a API HTTP oferece
Uma requisição, vários dispositivos
Um único POST pode levar até 500 dispositivos e 5.000 valores, cada um com o seu próprio horário. Dispositivos e canais são criados automaticamente na primeira mensagem.
Incluído em BusinessUnidades convertidas para você
Envie energia em Wh, kWh ou MWh, temperaturas em °C ou °F, velocidade de vibração em mm/s ou in/s: o FreeMaint guarda cada grandeza numa única unidade, para que valores vindos de sistemas diferentes possam ser somados.
Incluído em BusinessContadores tratados como contadores
Marque um valor como cumulativo, como um total de energia ou um contador de horas de funcionamento, e o FreeMaint calcula o consumo entre as leituras, mesmo depois de um reset.
Incluído em BusinessOs mesmos alertas e ordens de serviço de qualquer dispositivo
Quando um valor chega, ele é um canal como outro qualquer: regras de alerta, zonas de vibração da ISO 20816, horas de funcionamento, vínculo com medidores do ativo e medidores de energia, e a visualização ao vivo no aplicativo móvel.
Incluído em BusinessUma chave por conexão
Cada conexão tem a sua própria chave de acesso, enviada num cabeçalho e nunca na URL. Troque-a quando quiser, mantendo a antiga válida por 24 horas ou revogando-a na hora.
Incluído em BusinessQuando a API HTTP é o caminho certo
O FreeMaint decodifica sozinho alguns dispositivos: os medidores de energia Shelly e dois sensores LoRaWAN da Milesight. Todo o resto passa pela API HTTP, e isso cobre a maior parte de uma planta industrial: um analisador de energia Modbus lido pelo Node-RED, um sensor do Home Assistant, um sistema de automação predial que exporta seus pontos, um CLP que já publica os seus contadores, um sensor de vibração lido pelo seu próprio gateway.
O FreeMaint não fala Modbus, MQTT, BACnet nem OPC UA diretamente. É uma escolha deliberada: o gateway que já está na sua rede conhece o protocolo e o mapa de registradores, e o FreeMaint só precisa dos valores. Um fluxo Node-RED ou um script curto que transforma registradores em JSON costuma ter poucas linhas.
- Fluxos Node-RED lendo dispositivos Modbus RTU ou TCP
- Automações do Home Assistant encaminhando sensores
- Roteadores Teltonika com Data to Server
- Gateways de CLP e de automação predial
- Scripts num pequeno PC ou num Raspberry Pi
Como é uma requisição
A requisição é um POST para a URL que o FreeMaint mostra quando você cria a conexão, com dois cabeçalhos: Authorization, com a chave de acesso, e Content-Type definido como application/json. O corpo lista itens: cada item é um identificador de dispositivo, um nome de exibição e um horário opcionais, e os seus pontos. Um ponto tem uma chave como power ou energy_total, um valor e, de preferência, uma unidade, uma grandeza e, para contadores, o tipo cumulativo.
O FreeMaint responde 202 quando os dados são aceitos e os grava em poucos segundos. Uma requisição malformada recebe uma resposta 400 que aponta o problema, para que um gateway mal configurado seja corrigido em minutos, e não descoberto semanas depois. Cada conexão aceita até 120 requisições por minuto; acima disso o FreeMaint responde 429 e o seu sistema deve tentar novamente mais tarde.
Horas de funcionamento e energia a partir do seu próprio sistema
Se o seu CLP já conta as horas de funcionamento, envie o contador como valor cumulativo e associe o canal ao medidor de horas do ativo: os planos preventivos disparam com base nele. Se ele só informa potência ou corrente, deixe o FreeMaint calcular as horas de funcionamento a partir desse canal com "Calcular horas de funcionamento". Para energia, associe o canal a um medidor de energia e o FreeMaint registra uma leitura a cada 15 minutos com o seu custo e o seu CO2.
Planos e limites
A API HTTP faz parte do FreeMaint Connect, no plano Business, por US$ 99 por mês por empresa, preço fixo, com 100 canais ativos. O plano Enterprise inclui 5.000. Um canal inativo não conta, e os dados já recebidos continuam visíveis em todos os planos. Para ler e gravar o resto do FreeMaint, como ordens de serviço, ativos e peças, existe também uma API GraphQL no plano Business e webhooks de saída assinados a partir do plano Starter.
Envie seus primeiros valores em quatro passos
- 1
Crie a conexão
Em Dispositivos conectados → Integrações, clique em "Conectar um dispositivo" e escolha "API HTTP (Node-RED, script…)".
- 2
Copie a URL e a chave
O FreeMaint mostra a URL, os dois cabeçalhos e um exemplo de corpo. A chave é exibida uma única vez.
- 3
Envie uma requisição
A partir do Node-RED, do Home Assistant ou do seu script, faça um POST do JSON com os dois cabeçalhos.
- 4
Use os canais
Vincule o novo dispositivo ao seu ativo, adicione regras de alerta e associe os canais aos medidores.
Perguntas frequentes
O FreeMaint consegue ler o meu medidor Modbus diretamente?
Não. Um gateway lê os registradores Modbus, seja o Node-RED, o Home Assistant, um roteador Teltonika ou um script, e envia os valores ao FreeMaint em JSON por HTTPS.
O MQTT é suportado?
Não diretamente. Um gateway que assina os seus tópicos MQTT, como o Node-RED, pode encaminhar os valores para a API HTTP.
Quantos valores uma requisição pode levar?
Até 500 dispositivos e 5.000 pontos por requisição, e até 120 requisições por minuto por conexão.
O que acontece se a minha requisição estiver errada?
O FreeMaint responde 400 e aponta o problema, para que você corrija o gateway na hora. Os dados aceitos recebem um 202.
Os valores enviados pelo meu script podem abrir ordens de serviço?
Sim. Quando um valor chega, ele é um canal: uma regra de alerta com "Criar uma ordem de serviço" marcado abre uma ordem de serviço no ativo.
De qual plano eu preciso?
Do Business, por US$ 99 por mês por empresa, com 100 canais ativos. O Enterprise inclui 5.000.
Páginas relacionadas
Aproveite os dados que você já tem
Comece no plano Core gratuito e passe para o Business quando estiver pronto para enviar medições.
Criar minha conta grátis