Corriger les VALEURS d’une version de réglage

PATCH /irrigation/installations/{versionId}

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

Répare une saisie fausse SANS créer de version, sans déplacer de borne de validité et sans recalculer aucune dose. À ne pas confondre avec le PUT, qui déclare un changement de matériel réel.

Paramètres de chemin

• versionId integer obligatoire

  Identifiant d’une VERSION de réglage (champ id de versions[]).

En-têtes

• Idempotency-Key string

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

Corps de la requête

• system string obligatoire

  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
• emitterFlowLph number

  Débit d’un goutteur, en L/h (imprimé sur le matériel).

• emittersPerM2 number

  Goutteurs par m² = 1 ÷ (écartement goutteurs × écartement rampes, en m).

• flowMmPerH number

  Débit surfacique en mm/h. IGNORÉ si emitterFlowLph ET emittersPerM2 sont fournis — la géométrie est la saisie la plus précise, et laisser les deux diverger produirait des mm dont personne ne saurait dire d’où ils sortent.

• irrigatedAreaM2 number

  Surface irriguée en m². Nécessaire pour convertir un volume (m³) en mm.

• fractionWetted number

  Fraction de sol mouillée (fw). À NE PAS renseigner en temps normal : le défaut du système (FAO-56 table 20) s’applique. Réservé aux installations atypiques.

• notes string
• effectiveFrom string date-time

  Date d’EFFET terrain. Absente = maintenant, SAUF pour le tout premier réglage applicable à la cible (aucune version ni pour elle ni, pour une sonde, pour sa parcelle) : il vaut alors depuis toujours (validFrom = 1970-01-01T00:00:00Z), pour que les arrosages déjà saisis reçoivent leur dose. Une date passée documente l’époque : la version couvrant cette date est close à cet instant, et les versions postérieures sont INTACTES. Le futur est refusé (EFFECTIVE_FROM_IN_FUTURE).

Réponse

200

Corrigé

• success boolean toujours présent

Erreurs

• 400

  Saisie refusée

  INVALID_SYSTEMINVALID_EMITTER_FLOWINVALID_EMITTER_DENSITYINVALID_FLOW_RATEINVALID_FRACTION_WETTEDINVALID_IRRIGATED_AREAINVALID_EFFECTIVE_FROMEFFECTIVE_FROM_IN_FUTUREINSTALLATION_VERSION_EXISTS_AT_DATE
• 401

  Non authentifié

• 403

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

• 404

  Version introuvable

  INSTALLATION_NOT_FOUND

PATCH /irrigation/installations/{versionId}

cURL JavaScript Python

curl -X PATCH https://api.hub.akuasense.com/v1/irrigation/installations/1 \
  -H "x-api-key: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "system": "drip",
    "emitterFlowLph": 4,
    "emittersPerM2": 0.16,
    "irrigatedAreaM2": 5000
  }'

const response = await fetch(
  'https://api.hub.akuasense.com/v1/irrigation/installations/1',
  {
    method: 'PATCH',
    headers: {
      'x-api-key': 'VOTRE_CLE_API',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      "system": "drip",
      "emitterFlowLph": 4,
      "emittersPerM2": 0.16,
      "irrigatedAreaM2": 5000
    }),
  },
);
const data = await response.json();

import requests

response = requests.patch(
    "https://api.hub.akuasense.com/v1/irrigation/installations/1",
    headers={"x-api-key": "VOTRE_CLE_API"},
    json={
        "system": "drip",
        "emitterFlowLph": 4,
        "emittersPerM2": 0.16,
        "irrigatedAreaM2": 5000,
    },
)
data = response.json()

Réponse

200 400 401 403 404

{
  "success": true
}

application/json

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

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

{
  "type": "string",
  "title": "string",
  "status": 404,
  "detail": "string",
  "code": "INSTALLATION_NOT_FOUND"
}

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