Recette de pont MQTT

Gardez Mosquitto ou le MQTT de Home Assistant sur votre LAN et répliquez les relevés vers ProbeHarbor en HTTPS pour les alertes gel et fuite et l’historique.

Gros plan de câbles Ethernet Cat-5e blancs avec connecteurs RJ45 — Le JSON des sondes quitte généralement le LAN par Ethernet ou via un relais proche, pas directement par Internet. Photo : DiscDepotDundee.co.uk. CC BY-SA 4.0

ProbeHarbor n’est pas un broker MQTT. Gardez Mosquitto, ESPHome ou le MQTT de Home Assistant sur votre réseau local, puis répliquez les topics choisis en HTTPS : les SMS et e-mails d’alerte gel et fuite du foyer ainsi que l’historique vivent dans le cloud, sans exposer le broker.

Pont rapide (curl)

Créez un appareil push dans Dashboard → Devices, copiez la clé d’ingestion, faites correspondre les clés JSON à votre payload MQTT, puis envoyez un POST :

curl -X POST "https://probeharbor.dev/api/ingest/mqtt" \
  -H "Content-Type: application/json" \
  -H "X-Ingest-Key: YOUR_DEVICE_KEY" \
  -d '{"topic":"home/garage/temp","message":{"temp1":42.5,"humidity":38}}'

La création complète d’appareils (push ou pull) est décrite dans Ajouter des appareils push et pull. Formats de payload et webhooks d’alerte sortants : API d’ingestion et webhooks d’alerte.

`rest_command` dans Home Assistant

Vous préférez des entités automatiques à partir d’un lien de partage ? Utilisez l’intégration HACS officielle. Pour une simple réplication MQTT :

# configuration.yaml
rest_command:
  probeharbor_ingest:
    url: "https://probeharbor.dev/api/ingest/mqtt"
    method: POST
    headers:
      Content-Type: application/json
      X-Ingest-Key: !secret probeharbor_ingest_key
    payload: >
      {"topic":"{{ trigger.topic }}","payload":{{ trigger.payload }}}

automation:
  - alias: ProbeHarbor MQTT bridge
    trigger:
      - platform: mqtt
        topic: home/garage/temp
    action:
      - service: rest_command.probeharbor_ingest

Node-RED

Importez mqtt-to-probeharbor.json, pointez les nœuds MQTT vers votre broker, définissez PROBEHARBOR_INGEST_KEY et déployez. Guide produit : intégration Node-RED. Version détaillée : documentation développeur du pont MQTT.

FAQ

Faut-il abandonner MQTT pour utiliser ProbeHarbor ?
Non. Gardez Mosquitto/Home Assistant pour les automatisations locales et envoyez l’ingestion en POST HTTPS pour les alertes de gel/fuite et l’historique de ProbeHarbor.

Que publie la passerelle MQTT ?
Elle convertit les topics du broker en JSON d’ingestion ProbeHarbor (températures, portes, fuites). Détails : probeharbor.dev/about/mqtt-bridge.

TLS est-il obligatoire vers probeharbor.dev ?
Oui pour l’ingestion dans le cloud. MQTT peut rester sur votre réseau local ; la passerelle ou l’appareil doit envoyer un POST HTTPS à votre URL d’ingestion.