Appareils connectés · API HTTP

Node-RED, Home Assistant ou votre script, reliés à la maintenance

Beaucoup de sites lisent déjà leurs compteurs quelque part : un flux Node-RED qui interroge un analyseur Modbus, une instance Home Assistant avec une douzaine de capteurs, une passerelle d’automate, un script Python sur un petit PC. FreeMaint Connect permet à chacun d’eux d’envoyer ses valeurs en une requête HTTP, pour que ces mesures atteignent enfin les équipements, les alertes et les ordres de travail.

Inclus dans Business· $99/mois par entreprise
Créer mon compte gratuit Voir les tarifs

Free your maintenance · Offre Core gratuite, utilisateurs illimités, sans carte bancaire.

En bref

FreeMaint Connect accepte les mesures de tout système capable d’envoyer du JSON en HTTP : Node-RED, Home Assistant, une passerelle Modbus ou d’automate, un routeur Teltonika ou un script. Chaque requête porte une clé d’accès dans son en-tête et liste des appareils avec leurs valeurs ; FreeMaint convertit les unités, crée les canaux au premier message, et les règles d’alerte, compteurs d’heures et compteurs d’énergie les utilisent comme pour tout appareil certifié.

Mis à jour le 16 octobre 2026

Ce que vous apporte l’API HTTP

Une requête, de nombreux appareils

Un seul POST peut transporter jusqu’à 500 appareils et 5 000 valeurs, chacune avec son propre horodatage. Appareils et canaux sont créés automatiquement à leur premier message.

Inclus dans Business

Des unités converties pour vous

Envoyez l’énergie en Wh, kWh ou MWh, les températures en °C ou °F, la vitesse vibratoire en mm/s ou in/s : FreeMaint enregistre chaque grandeur dans une seule unité, pour que les valeurs issues de systèmes différents s’additionnent.

Inclus dans Business

Des compteurs compris comme des compteurs

Marquez une valeur comme cumulative — un total d’énergie, un compteur d’heures — et FreeMaint calcule la consommation entre deux relevés, même après une remise à zéro.

Inclus dans Business

Les mêmes alertes et ordres de travail que pour tout appareil

Une fois arrivée, une valeur est un canal comme les autres : règles d’alerte, zones vibratoires ISO 20816, heures de fonctionnement, liens vers les compteurs d’équipement et d’énergie, et affichage en direct dans l’application mobile.

Inclus dans Business

Une clé par connexion

Chaque connexion a sa propre clé d’accès, envoyée dans un en-tête et jamais dans l’URL. Remplacez-la à tout moment, en gardant l’ancienne valide 24 heures ou en la révoquant immédiatement.

Inclus dans Business

Quand l’API HTTP est la bonne voie

FreeMaint décode lui-même quelques appareils — les compteurs d’énergie Shelly et deux capteurs LoRaWAN Milesight. Tout le reste passe par l’API HTTP, et cela couvre l’essentiel d’un site industriel : un analyseur de réseau Modbus lu par Node-RED, un capteur Home Assistant, une gestion technique du bâtiment qui exporte ses points, un automate qui publie déjà ses compteurs, un capteur de vibration lu par sa propre passerelle.

FreeMaint ne parle pas directement Modbus, MQTT, BACnet ni OPC UA. C’est volontaire : la passerelle déjà présente sur votre réseau connaît le protocole et la table des registres, et FreeMaint n’a besoin que des valeurs. Un flux Node-RED ou un petit script qui transforme des registres en JSON tient généralement en quelques lignes.

  • Flux Node-RED qui lisent des appareils Modbus RTU ou TCP
  • Automatisations Home Assistant qui transmettent des capteurs
  • Routeurs Teltonika avec Data to Server
  • Passerelles d’automates et de gestion technique du bâtiment
  • Scripts sur un petit PC ou un Raspberry Pi

À quoi ressemble une requête

La requête est un POST vers l’URL que FreeMaint affiche à la création de la connexion, avec deux en-têtes : Authorization, qui porte la clé d’accès, et Content-Type, réglé sur application/json. Le corps liste des éléments : chacun comprend un identifiant d’appareil, un nom d’affichage et un horodatage facultatifs, et ses points. Un point a une clé comme power ou energy_total, une valeur et, idéalement, une unité, une grandeur et, pour les compteurs, le type cumulatif.

FreeMaint répond 202 quand les données sont acceptées et les enregistre en quelques secondes. Une requête mal formée reçoit une réponse 400 qui nomme le problème : une passerelle mal configurée se corrige en quelques minutes au lieu d’être découverte des semaines plus tard. Chaque connexion accepte jusqu’à 120 requêtes par minute ; au-delà, FreeMaint répond 429 et votre système doit réessayer plus tard.

Heures de marche et énergie depuis votre propre système

Si votre automate compte déjà les heures de marche, envoyez le compteur comme valeur cumulative et liez le canal au compteur d’heures de l’équipement : les plans préventifs se déclenchent dessus. S’il ne remonte qu’une puissance ou un courant, laissez FreeMaint calculer les heures de fonctionnement à partir de ce canal. Pour l’énergie, liez le canal à un compteur d’énergie : FreeMaint enregistre un relevé toutes les 15 minutes avec son coût et son CO2.

Offres et limites

L’API HTTP fait partie de FreeMaint Connect, inclus dans l’offre Business à 99 $ par mois et par entreprise, au forfait, avec 100 canaux actifs. L’offre Enterprise en comprend 5 000. Un canal inactif n’est pas décompté, et les données déjà reçues restent consultables sur toutes les offres. Pour lire et écrire le reste de FreeMaint — ordres de travail, équipements, pièces — il existe aussi une API GraphQL dès l’offre Business et des webhooks sortants signés dès l’offre Starter.

Envoyez vos premières valeurs en quatre étapes

  1. 1

    Créez la connexion

    Dans Appareils connectés → Intégrations, cliquez sur Connecter un appareil et choisissez API HTTP (Node-RED, script…).

  2. 2

    Copiez l’URL et la clé

    FreeMaint affiche l’URL, les deux en-têtes et un exemple de corps. La clé n’est affichée qu’une seule fois.

  3. 3

    Envoyez une requête

    Depuis Node-RED, Home Assistant ou votre script, envoyez le JSON en POST avec les deux en-têtes.

  4. 4

    Exploitez les canaux

    Rattachez le nouvel appareil à son équipement, ajoutez des règles d’alerte et liez les canaux aux compteurs.

Questions fréquentes

FreeMaint peut-il lire directement mon compteur Modbus ?

Non. Une passerelle lit les registres Modbus — Node-RED, Home Assistant, un routeur Teltonika ou un script — et envoie les valeurs à FreeMaint en JSON par HTTPS.

MQTT est-il pris en charge ?

Pas directement. Une passerelle abonnée à vos topics MQTT, comme Node-RED, peut transmettre les valeurs à l’API HTTP.

Combien de valeurs une requête peut-elle transporter ?

Jusqu’à 500 appareils et 5 000 points par requête, et jusqu’à 120 requêtes par minute et par connexion.

Que se passe-t-il si ma requête est incorrecte ?

FreeMaint répond 400 et nomme le problème, pour que vous corrigiez la passerelle tout de suite. Les données acceptées reçoivent un 202.

Les valeurs de mon script peuvent-elles ouvrir des ordres de travail ?

Oui. Une fois arrivée, une valeur est un canal : une règle d’alerte avec Créer un ordre de travail coché ouvre un ordre de travail sur l’équipement.

De quelle offre ai-je besoin ?

L’offre Business, à 99 $ par mois et par entreprise, avec 100 canaux actifs. L’offre Enterprise en comprend 5 000.

Pages liées

Documentation

Valorisez les données que vous avez déjà

Démarrez sur l’offre Core gratuite, puis passez à Business quand vous êtes prêt à envoyer des mesures.

Créer mon compte gratuit