Passer le réglage de la sonde à sa parcelle

POST /modules/{moduleId}/irrigation/generalize

Scope irrigation:write
Clé API x-api-key
URL de base https://api.hub.akuasense.com/v1

Ouvre une version de portée parcelle avec les valeurs de la sonde, et clôt la portée sonde au MÊME instant. dropSiblings clôt aussi les réglages propres des autres sondes de la parcelle : leur nombre est donné par siblingOverrides, à montrer avant de cliquer.

Paramètres de chemin

moduleId integer obligatoire

En-têtes

Idempotency-Key string

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

Corps de la requête

dropSiblings boolean

Clore aussi les réglages propres des AUTRES sondes de la parcelle.

Par défaut : false

Réponse

200

Configuration après généralisation

moduleId integer
parcelId integer peut être null
installation IrrigationInstallation peut être null

Réglage EFFECTIF aujourd’hui, après résolution de portée. null = aucun réglage.
Afficher les 13 attributs Masquer les attributs
- id integer
- scope string
  
  Portée. Un réglage de sonde l’emporte EN BLOC sur celui de sa parcelle — jamais champ par champ.
  
  Valeurs : moduleparcel
- parcelId integer peut être null
- moduleId integer peut être null
- system string
  
  Type de matériel. Détermine la valeur par défaut de la fraction de sol mouillée (FAO-56 table 20) : drip 0,35 · micro_sprinkler 0,60 · tous les autres 1,00.
  
  Valeurs : dripmicro_sprinklersprinklerpivotgravitymanualother
- flowMmPerH number peut être null
  
  Débit surfacique en mm/h. Calculé quand la géométrie du goutte-à-goutte est fournie (emitterFlowLph × emittersPerM2), sinon saisi directement — c’est l’unité constructeur en aspersion et en pivot. null : une durée ne pourra pas être convertie en mm.
- emitterFlowLph number peut être null
  
  Débit d’UN goutteur, en L/h. C’est ce qui est imprimé sur le matériel.
- emittersPerM2 number peut être null
  
  Densité de goutteurs par m². Personne n’a ce chiffre en tête : il se déduit des écartements — 1 ÷ (écartement goutteurs × écartement rampes, en m), ou (goutteurs par arbre) ÷ (surface par arbre).
- fractionWetted number
  
  Fraction de sol mouillée (fw, FAO-56 table 20), 0 < fw ≤ 1. Toujours renseignée : valeur saisie, sinon défaut du système. Ne se demande pas à un agriculteur.
- fractionWettedIsDefault boolean
  
  true = issue du défaut du système, jamais saisie.
- irrigatedAreaM2 number peut être null
  
  Surface irriguée en m². Requise pour convertir un volume en mm.
- validFrom string date-time
  
  Date d’EFFET terrain de cette version.
- validTo string date-time peut être null
  
  Borne haute EXCLUE. null = version courante.
defaultFractionWetted number peut être null

Ce que vaudrait fw si elle n’était pas saisie.
placement IrrigationPlacement peut être null

Implantation de la sonde par rapport au goutteur. ⚠️ N’entre dans AUCUN calcul et ne doit pas y entrer : c’est une variable d’observation, destinée à expliquer après coup pourquoi un capteur reste muet (sonde plantée hors du bulbe).
Afficher les 3 attributs Masquer les attributs
- emitterDistanceCm integer peut être null
  
  Distance au goutteur le plus proche, en cm. 0 est légitime.
- notes string peut être null
- setAt string date-time
canGeneralize boolean

Le réglage de cette sonde peut-il être passé à la parcelle ?
hasParcelInstallation boolean

Existe-t-il un réglage de parcelle vers lequel retomber ?
siblingOverrides integer

Nombre d’AUTRES sondes de la parcelle portant leur propre réglage courant — ce que generalize avec dropSiblings écraserait.
versions tableau d’IrrigationInstallationVersion

Historique complet applicable à cette sonde — ses versions ET celles de sa parcelle, chacune étiquetée par sa portée, du plus récent au plus ancien.
Afficher les 15 attributs Masquer les attributs
- id integer
- scope string
  
  Portée. Un réglage de sonde l’emporte EN BLOC sur celui de sa parcelle — jamais champ par champ.
  
  Valeurs : moduleparcel
- parcelId integer peut être null
- moduleId integer peut être null
- system string
  
  Type de matériel. Détermine la valeur par défaut de la fraction de sol mouillée (FAO-56 table 20) : drip 0,35 · micro_sprinkler 0,60 · tous les autres 1,00.
  
  Valeurs : dripmicro_sprinklersprinklerpivotgravitymanualother
- flowMmPerH number peut être null
  
  Débit surfacique en mm/h. Calculé quand la géométrie du goutte-à-goutte est fournie (emitterFlowLph × emittersPerM2), sinon saisi directement — c’est l’unité constructeur en aspersion et en pivot. null : une durée ne pourra pas être convertie en mm.
- emitterFlowLph number peut être null
  
  Débit d’UN goutteur, en L/h. C’est ce qui est imprimé sur le matériel.
- emittersPerM2 number peut être null
  
  Densité de goutteurs par m². Personne n’a ce chiffre en tête : il se déduit des écartements — 1 ÷ (écartement goutteurs × écartement rampes, en m), ou (goutteurs par arbre) ÷ (surface par arbre).
- fractionWetted number
  
  Fraction de sol mouillée (fw, FAO-56 table 20), 0 < fw ≤ 1. Toujours renseignée : valeur saisie, sinon défaut du système. Ne se demande pas à un agriculteur.
- fractionWettedIsDefault boolean
  
  true = issue du défaut du système, jamais saisie.
- irrigatedAreaM2 number peut être null
  
  Surface irriguée en m². Requise pour convertir un volume en mm.
- validFrom string date-time
  
  Date d’EFFET terrain de cette version.
- validTo string date-time peut être null
  
  Borne haute EXCLUE. null = version courante.
- setAt string date-time
  
  Date de la SAISIE, distincte de validFrom qui est la date d’effet sur le terrain.
- notes string peut être null
missingDoses object

Arrosages enregistrés dont la dose n’a jamais pu être calculée.
Afficher les 3 attributs Masquer les attributs
- count integer
- withoutInstallation integer
  
  Part d’entre eux qu’aucun recompute ne pourra compléter : aucune version de réglage ne couvre leur date. Le geste utile est alors de déclarer un réglage rétroactif.
- oldestWithoutInstallation string date-time peut être null

Erreurs

400
Saisie refusée

MODULE_HAS_NO_PARCELNO_MODULE_INSTALLATION
401
Non authentifié
403
Scope/rôle insuffisant ou hors société

POST /modules/{moduleId}/irrigation/generalize

curl -X POST https://api.hub.akuasense.com/v1/modules/133/irrigation/generalize \
  -H "x-api-key: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "dropSiblings": false
  }'

const response = await fetch(
  'https://api.hub.akuasense.com/v1/modules/133/irrigation/generalize',
  {
    method: 'POST',
    headers: {
      'x-api-key': 'VOTRE_CLE_API',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      "dropSiblings": false
    }),
  },
);
const data = await response.json();

import requests

response = requests.post(
    "https://api.hub.akuasense.com/v1/modules/133/irrigation/generalize",
    headers={"x-api-key": "VOTRE_CLE_API"},
    json={
        "dropSiblings": False,
    },
)
data = response.json()

Réponse

{
  "moduleId": 133,
  "parcelId": 21,
  "installation": {
    "id": 42,
    "scope": "module",
    "parcelId": null,
    "moduleId": 133,
    "system": "drip",
    "flowMmPerH": 0.64,
    "emitterFlowLph": 4,
    "emittersPerM2": 0.16,
    "fractionWetted": 0.35,
    "fractionWettedIsDefault": true,
    "irrigatedAreaM2": 5000,
    "validFrom": "2026-04-01T00:00:00.000Z",
    "validTo": null
  },
  "defaultFractionWetted": 0.35,
  "placement": {
    "emitterDistanceCm": 35,
    "notes": "Sonde entre deux goutteurs du rang nord",
    "setAt": "2026-09-02T09:14:00.000Z"
  },
  "canGeneralize": false,
  "hasParcelInstallation": true,
  "siblingOverrides": 2,
  "versions": [
    {
      "id": 42,
      "scope": "module",
      "parcelId": null,
      "moduleId": 133,
      "system": "drip",
      "flowMmPerH": 0.64,
      "emitterFlowLph": 4,
      "emittersPerM2": 0.16,
      "fractionWetted": 0.35,
      "fractionWettedIsDefault": true,
      "irrigatedAreaM2": 5000,
      "validFrom": "2026-04-01T00:00:00.000Z",
      "validTo": null,
      "setAt": "2026-04-03T10:22:00.000Z",
      "notes": "Passage en 4 L/h"
    },
    {
      "id": 31,
      "scope": "module",
      "parcelId": null,
      "moduleId": 133,
      "system": "drip",
      "flowMmPerH": 0.32,
      "emitterFlowLph": 2,
      "emittersPerM2": 0.16,
      "fractionWetted": 0.35,
      "fractionWettedIsDefault": true,
      "irrigatedAreaM2": 5000,
      "validFrom": "2025-05-14T00:00:00.000Z",
      "validTo": "2026-04-01T00:00:00.000Z",
      "setAt": "2025-05-14T08:00:00.000Z",
      "notes": null
    }
  ],
  "missingDoses": {
    "count": 3,
    "withoutInstallation": 3,
    "oldestWithoutInstallation": "2025-03-12T05:00:00.000Z"
  }
}

application/json

{
  "type": "string",
  "title": "string",
  "status": 400,
  "detail": "string",
  "code": "MODULE_HAS_NO_PARCEL"
}

application/problem+json · exemple généré depuis le schéma

{
  "type": "string",
  "title": "string",
  "status": 401,
  "detail": "string",
  "code": "string"
}

application/problem+json · exemple généré depuis le schéma

{
  "type": "string",
  "title": "string",
  "status": 403,
  "detail": "string",
  "code": "string"
}

application/problem+json · exemple généré depuis le schéma