Afficher la passerelle chez soi avec l'API d'Ici VidourleAfficher la passerelle chez soi avec l'API d'Ici Vidourle

L'adresse

Une requête GET suffit. La réponse est un JSON, ouvert à tous les sites (CORS), le même pour tout le monde.

https://www.ici-vidourle.com/api/v1/etat

Pour essayer depuis un terminal :

curl -s https://www.ici-vidourle.com/api/v1/etat

Les paramètres ajoutés à l'adresse sont ignorés. Une seconde adresse, /api/v1/sante, répond 200 quand la collecte va bien et 503 quand une source ne répond plus : elle sert aux services de surveillance.

Ce que contient la réponse

Les dates sont en UTC (format ISO), les hauteurs en mètres, les débits en m³/s et la pluie en millimètres. Les principaux champs :

• passerelle.etat : ouverte, fermee, submergee ou inconnue.
• passerelle.certitude : confirme quand l'état vient de la mairie ou des habitants, probable quand c'est une estimation d'après le niveau. Une estimation doit toujours s'afficher « probablement … ».
• passerelle.origine, source, depuis et annonce_url : qui l'a dit, depuis quand, et le lien vers l'annonce de la mairie.
• fermeture_possible.actif : vrai quand au moins 20 mm de pluie sont prévus en 48 h en amont, ou en cas de vigilance orange ou rouge. Ce n'est pas une annonce : seule la mairie décide.
• sommieres : hauteur, débit, variation sur 1 h, tendance (monte, stable, baisse) et état du fleuve en un mot (« Calme », « Ça monte »…).
• stations : Saint-Hippolyte-du-Fort, Quissac, Vic-le-Fesq et Gallargues, à retrouver par leur code. Pour le barrage de Conqueyrac (grandeur = cote_retenue), la valeur est l'altitude du lac, pas une hauteur d'eau.
• vigilance : vigilance crues du Vidourle et vigilance météo pluie et orages, aujourd'hui et demain, du niveau 1 (vert) à 4 (rouge).
• collecte et sources : santé de la collecte, puis les sources et leurs licences.

Un extrait :

{
  "version": 1,
  "genere_at": "2026-11-13T08:21:31.555Z",
  "passerelle": {
    "etat": "fermee",
    "certitude": "confirme",
    "origine": "mairie",
    "depuis": "2026-11-10T06:25:00+00:00",
    "source": "Mairie · Facebook",
    "perime": false
  },
  "fermeture_possible": { "actif": false, "pluie_amont_48h_mm": 10.3, "seuil_pluie_48h_mm": 20 },
  "sommieres": { "hauteur_m": 0.625, "tendance": "stable", "etat": "Haut", "perime": false }
}

Quand une donnée n'est plus fiable

Chaque bloc porte un champ perime. Il passe à true quand la dernière mesure a plus d'une heure : la collecte s'est arrêtée et la valeur ne vaut plus rien. Pour la passerelle, il passe aussi à true quand la page de la mairie n'est plus lue alors qu'elle est dite ouverte : une fermeture annoncée depuis pourrait manquer. Le champ genere_at dit quand la réponse a été calculée.

Dans ces deux cas, affichez la donnée comme indisponible. Ne la laissez jamais à sa dernière valeur, et n'affichez jamais la passerelle « ouverte » par défaut.

Entre une annonce de la mairie et votre écran, comptez jusqu'à une dizaine de minutes.

Ce délai s'additionne : la collecte passe toutes les 5 minutes, la réponse est gardée en cache une minute, puis votre outil l'interroge à son rythme. Quand la mairie publie tard, ou pas du tout, l'appli le sait aussi tard que vous.

Dans Home Assistant

Ajoutez ce bloc à votre fichier configuration.yaml, puis redémarrez Home Assistant. Il crée trois entités tirées d'un seul appel toutes les 5 minutes : l'état de la passerelle, la hauteur à Sommières et « fermeture possible ». Chacune devient indisponible quand sa donnée est périmée.

rest:
  - resource: https://www.ici-vidourle.com/api/v1/etat
    scan_interval: 300
    timeout: 30
    sensor:
      - name: "Vidourle passerelle"
        unique_id: vidourle_passerelle
        icon: mdi:bridge
        value_template: "{{ value_json.passerelle.etat }}"
        availability: >-
          {{ value_json is defined
             and not value_json.passerelle.perime
             and (now() - as_datetime(value_json.genere_at)).total_seconds() < 1200 }}
        json_attributes_path: "$.passerelle"
        json_attributes:
          - certitude
          - origine
          - depuis
          - source
          - annonce_url
      - name: "Vidourle Sommières hauteur"
        unique_id: vidourle_sommieres_hauteur
        value_template: "{{ value_json.sommieres.hauteur_m }}"
        unit_of_measurement: "m"
        device_class: distance
        state_class: measurement
        availability: "{{ value_json is defined and not value_json.sommieres.perime }}"
        json_attributes_path: "$.sommieres"
        json_attributes:
          - tendance
          - etat
          - mesure_at
    binary_sensor:
      - name: "Vidourle fermeture possible"
        unique_id: vidourle_fermeture_possible
        device_class: safety
        value_template: "{{ value_json.fermeture_possible.actif }}"
        json_attributes_path: "$.fermeture_possible"
        json_attributes:
          - raison
          - pluie_amont_48h_mm

Pour être prévenu d'une fermeture, une automatisation qui cite sa source et rappelle la signalisation :

automation:
  - alias: "Passerelle de Sommières fermée"
    triggers:
      - trigger: state
        entity_id: sensor.vidourle_passerelle
        to: ["fermee", "submergee"]
    actions:
      - action: notify.notify
        data:
          message: >-
            Passerelle de Sommières :
            {{ 'probablement ' if trigger.to_state.attributes.certitude == 'probable' }}
            {{ 'submergée' if trigger.to_state.state == 'submergee' else 'fermée' }}
            ({{ trigger.to_state.attributes.source }}).
            Les grilles et la signalisation sur place font toujours foi.

Vous voulez aussi les stations en amont, les vigilances et une carte de tableau de bord ? Donnez à un assistant comme Claude le texte ci-dessous : il écrira la configuration complète en respectant les mêmes règles.

Aide-moi à ajouter dans Home Assistant les informations d'Ici Vidourle,
une application non officielle qui suit le Vidourle à Sommières (Gard)
et l'état de la passerelle submersible. Donne-moi une configuration
YAML complète, prête à coller, et explique où la mettre.

Source : https://www.ici-vidourle.com/api/v1/etat (GET, JSON, sans clé).
Lis d'abord une réponse réelle pour connaître le format.

- Une seule ressource rest:, scan_interval: 300, jamais moins.
- Capteurs préfixés vidourle_ avec unique_id : état de la passerelle
  (valeurs brutes), un libellé lisible qui écrit « Probablement … »
  quand certitude vaut probable, fermeture possible, hauteur, débit et
  variation à Sommières, une entité par station trouvée par son code
  (Conqueyrac : altitude du lac, pas une hauteur), vigilances crues et
  météo, santé de la collecte.
- Une entité devient indisponible quand son champ perime vaut true ou
  quand genere_at a plus de 20 minutes. La passerelle n'est jamais
  « ouverte » par défaut.
- Automatisations d'exemple désactivées par défaut (fermeture,
  réouverture, fermeture possible, montée de plus de 10 cm en 2 h en
  amont). Chaque message cite la source et l'heure, et aucun ne dit
  « vous pouvez traverser » ni rien d'équivalent.
- Une carte de tableau de bord avec des cartes standard, terminée par :
  « Données Ici Vidourle (non officiel). Les grilles et la
  signalisation sur place font toujours foi. »

Dans un autre outil

Jeedom, un widget de téléphone ou une page web lisent la même adresse. Depuis un navigateur :

const reponse = await fetch("https://www.ici-vidourle.com/api/v1/etat");
const { passerelle } = await reponse.json();

Les mêmes règles valent partout : une estimation s'affiche « probablement », une donnée périmée s'efface, et chaque information garde sa source et son heure.

Conditions d'usage

• Non officielle et sans garantie : la réponse peut être en retard, fausse ou indisponible. Ne l'utilisez pas pour décider de traverser.
• Pas plus d'un appel toutes les 5 minutes. Au-delà, vous recevez la même réponse et pesez sur un service gratuit tenu bénévolement.
• Citez les sources listées dans le champ sources : Hub'Eau, Vigicrues et Météo-France (Licence Ouverte 2.0), Open-Meteo (CC BY 4.0), mairie de Sommières.
• Version 1 : des champs peuvent s'ajouter, aucun n'est renommé ni retiré sans passer à /api/v2.

Les grilles et la signalisation sur place font toujours foi.