Distance de la sonde au goutteur

PUT /modules/{moduleId}/irrigation/placement

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

Variable d’OBSERVATION : elle n’entre dans aucun calcul et ne doit pas y entrer. Elle sert à expliquer après coup pourquoi un capteur reste muet — sonde plantée hors du bulbe d’humidification.

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

emitterDistanceCm integer

Distance au goutteur le plus proche, en cm. 0 est légitime.
notes string

Réponse

200

Configuration après écriture

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

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

PUT /modules/{moduleId}/irrigation/placement

curl -X PUT https://api.hub.akuasense.com/v1/modules/133/irrigation/placement \
  -H "x-api-key: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "emitterDistanceCm": 35,
    "notes": "Sonde entre deux goutteurs du rang nord"
  }'

const response = await fetch(
  'https://api.hub.akuasense.com/v1/modules/133/irrigation/placement',
  {
    method: 'PUT',
    headers: {
      'x-api-key': 'VOTRE_CLE_API',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      "emitterDistanceCm": 35,
      "notes": "Sonde entre deux goutteurs du rang nord"
    }),
  },
);
const data = await response.json();

import requests

response = requests.put(
    "https://api.hub.akuasense.com/v1/modules/133/irrigation/placement",
    headers={"x-api-key": "VOTRE_CLE_API"},
    json={
        "emitterDistanceCm": 35,
        "notes": "Sonde entre deux goutteurs du rang nord",
    },
)
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": true,
  "hasParcelInstallation": false,
  "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": "INVALID_EMITTER_DISTANCE"
}

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