Aller au contenu
docs

Corriger un arrosage

PATCH /irrigation/events/{eventId}
  • Scope irrigation:write
  • Clé API x-api-key
  • URL de base https://api.hub.akuasense.com/v1

Corps identique à la création. ⚠️ Une occurrence issue d’un programme devient isDetached : la régénération nocturne ne la reprendra plus jamais. Corriger la DATE peut changer la dose — l’arrosage change de période, donc potentiellement de matériel.

Paramètres de chemin

  • eventId integer obligatoire

En-têtes

  • Idempotency-Key string

    Rejoue la même réponse 2xx (24 h)

Corps de la requête

  • startedAt string date-time obligatoire
  • endedAt string date-time
  • inputMode string obligatoire

    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
  • durationMin integer

    Durée en minutes. Alternative à endedAt — une seule des deux est stockée.

  • inputDepthMm number

    Hauteur d’eau en mm. Requise en mode depth_mm, et alors reprise telle quelle.

  • inputVolumeM3 number

    Volume en m³. Requis en mode volume_m3.

  • status string

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

    Valeurs : planneddoneskipped
  • note string

Réponse

200

Arrosage corrigé

  • event 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
  • warnings tableau d’IrrigationWarning

    Pourquoi la dose n’a pas pu être calculée, ou sur quelle hypothèse elle repose. AUCUN n’est bloquant : l’arrosage est enregistré quoi qu’il arrive, waterMm restant simplement null.

    Valeurs : NO_INSTALLATIONMISSING_FLOW_RATEMISSING_IRRIGATED_AREADEFAULT_FRACTION_WETTED

Erreurs

  • 400

    Saisie refusée

    INVALID_INPUT_MODEINVALID_DURATIONINVALID_ENDED_ATENDED_BEFORE_STARTEDINVALID_DEPTHINVALID_VOLUMEMISSING_DURATIONMISSING_DEPTHMISSING_VOLUMEINVALID_STARTED_ATINVALID_STATUS
  • 401

    Non authentifié

  • 403

    Scope/rôle insuffisant ou hors société

  • 404

    Arrosage introuvable

    EVENT_NOT_FOUND