Aller au contenu
docs

Programmes alimentant une sonde

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

Les programmes visant cette sonde ET ceux visant sa parcelle : du point de vue de la sonde, les deux sont « ses » programmes.

Paramètres de chemin

  • moduleId integer obligatoire

Réponse

200

Programmes, du plus récent au plus ancien

  • module_id integer
  • data tableau d’IrrigationSchedule

    Règle de tour d’eau. ⚠️ Elle est MATÉRIALISÉE en occurrences réelles dans le journal (horizon 90 jours, balayage nocturne) : un programme déclare donc de l’eau.

    Afficher les 18 attributs Masquer les attributs
    • id integer
    • targetParcelId integer peut être null
    • targetModuleId integer peut être null
    • label string peut être null
    • freq string
      Valeurs : dailyweekly
    • intervalDays integer peut être null

      En daily : tous les N jours (1–365). null en weekly.

    • weekdays tableau d’integer peut être null

      En weekly : jours retenus, 1 = lundi … 7 = dimanche. null ou vide en daily.

    • startTimes tableau de string

      Heures LOCALES de déclenchement (HH:MM), 1 à 12. Un tableau, pas une valeur : l’irrigation automatique tourne couramment matin ET soir.

    • timezone string

      Fuseau IANA, obligatoire et jamais UTC : 06:00 doit rester 06:00 chez le client de part et d’autre du changement d’heure.

    • 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
    • durationMin integer peut être null
    • inputDepthMm number peut être null
    • inputVolumeM3 number peut être null
    • startsOn string date
    • endsOn string date peut être null
    • confirmationPolicy string

      auto (défaut) : les occurrences passées basculent seules en done, avec verifiedAt à null — on distingue donc « le programme dit que c’est arrosé » de « quelqu’un l’a vérifié ». manual : elles restent planned jusqu’à confirmation.

      Valeurs : automanual
    • isActive boolean
    • materializedUntil string date-time peut être null

      Jusqu’où les occurrences ont été produites.

Erreurs

  • 401

    Non authentifié

  • 403

    Scope insuffisant ou ressource hors société

  • 404

    Introuvable