Aller au contenu
docs

Journal des arrosages d’une sonde

GET /modules/{moduleId}/irrigation/events
  • Scope irrigation:read
  • Clé API x-api-key
  • URL de base https://api.hub.akuasense.com/v1

Fenêtre obligatoire, bornée sur le CHEVAUCHEMENT et non sur startedAt seul : un arrosage commencé la veille au soir et fini le matin appartient bien à la journée qu’on regarde.

Paramètres de chemin

  • moduleId integer obligatoire

Paramètres de requête

  • from string date-time obligatoire

    Début de la fenêtre (ISO 8601). Obligatoire.

  • to string date-time obligatoire

    Fin de la fenêtre (ISO 8601). Obligatoire, et postérieure à from.

Réponse

200

Arrosages recoupant la fenêtre, du plus récent au plus ancien

  • module_id integer
  • from string date-time
  • to string date-time
  • data tableau d’IrrigationEvent

    Un apport d’eau, à la sonde. Les millimètres sont FIGÉS à l’écriture et ne sont jamais recalculés à la lecture.

    Afficher les 18 attributs Masquer les attributs
    • id integer
    • moduleId integer
    • scheduleId integer peut être null

      Programme dont cette ligne est une occurrence, le cas échéant.

    • isDetached boolean

      Occurrence de programme corrigée à la main : la régénération nocturne ne la reprendra plus jamais.

    • startedAt string date-time
    • durationMin integer peut être null

      Durée en minutes. null en depth_mm/volume_m3 sans durée déclarée.

    • endedAt string date-time peut être null

      Calculée (startedAt + durationMin), pas stockée. null si la durée est inconnue.

    • inputMode string

      Comment l’apport est déclaré. duration n’exige AUCUNE configuration (c’est le mode de repli universel) mais ne produit une dose que si le débit est connu ; depth_mm est pris tel quel ; volume_m3 exige la surface irriguée.

      Valeurs : durationdepth_mmvolume_m3
    • inputDepthMm number peut être null

      Valeur saisie en mode depth_mm, en mm.

    • inputVolumeM3 number peut être null

      Valeur saisie en mode volume_m3, en m³.

    • waterMm number peut être null

      Dose rapportée à la SURFACE TOTALE, en mm — le chiffre comparable à une pluie, à l’ETc ou au compteur d’eau. null = non convertible en l’état ; la ligne reste valide et s’affiche avec sa durée.

    • waterMmWetted number peut être null

      Dose dans la ZONE HUMIDIFIÉE (= waterMm ÷ fw), en mm — là où la sonde est plantée, et donc ce qui explique la hausse de VWC observée. null quand fw vaut 1 : les deux chiffres seraient identiques.

    • configSnapshot IrrigationConfigSnapshot peut être null

      Cliché des paramètres AYANT SERVI au calcul de cette ligne, figé à l’écriture. Distinct de l’historique d’installation : celui-ci dit quel matériel était en place à une date, le cliché dit ce qui a réellement servi — ils peuvent légitimement diverger si le réglage a été corrigé depuis.

      Afficher les 8 attributs Masquer les attributs
      • installationId integer peut être null

        Version de réglage utilisée.

      • scope string peut être null

        Portée d’où venait ce réglage.

        Valeurs : moduleparcelnull
      • system string peut être null
      • flowMmPerH number peut être null

        Débit surfacique retenu, en mm/h.

      • fractionWetted number peut être null

        Fraction de sol mouillée retenue (0 < fw ≤ 1).

      • fractionWettedIsDefault boolean

        true = valeur par défaut du système, non saisie.

      • irrigatedAreaM2 number peut être null

        Surface irriguée retenue, en m².

      • computedAt string date-time
    • status string

      planned = prévu, done = réalisé, skipped = annulé (jamais affiché sur les graphes).

      Valeurs : planneddoneskipped
    • source string

      D’où vient la ligne. manual = saisie dans le hub · schedule = occurrence matérialisée par un programme · api = cette API · mcp = assistant IA. En lecture seule : la source est posée par la surface qui écrit.

      Valeurs : manualscheduleapimcp
    • verifiedAt string date-time peut être null

      null = personne n’a confirmé cet arrosage (occurrence auto-confirmée par un programme).

    • note string peut être null
    • createdAt string date-time

Erreurs

  • 400

    Fenêtre invalide

    INVALID_RANGE
  • 401

    Non authentifié

  • 403

    Scope insuffisant ou ressource hors société