Déclarer culture+semis, plafond racinaire, ou prof. manuelle.

PUT /modules/{id}/crop

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

Effet de bord : efface les pondérations par profondeur saisies à la main (retour au calcul automatique).

Deux modes exclusifs : culture (cropId + plantingDate, et zrCapCm au besoin) ou manuel (manualZrCm). La déclaration remplace la culture active ; l’ancienne est close, jamais effacée.

Paramètres de chemin

• id integer obligatoire

En-têtes

• Idempotency-Key string

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

Corps de la requête

• cropId integer

  Culture : code de GET /reference/crops. Exclusif de manualZrCm.

• plantingDate string date

  Date de plantation ou de semis. Requise avec cropId.

• manualZrCm number

  Mode manuel : profondeur racinaire en cm, > 0. Exclusif de cropId.

• zrCapCm number

  Plafond de profondeur racinaire en cm (mode culture uniquement) : Zr = min(Zr_espèce, zrCapCm). Pour une parcelle dont la nappe, une semelle de labour ou une dalle tronque l’enracinement.

• notes string

Réponse

201

Déclaration enregistrée

• success boolean toujours présent
• row object toujours présent
  Afficher les 2 attributs Masquer les attributs

  • id integer toujours présent

    La déclaration créée : id de GET /modules/{id}/crop.

  • timestamp_start string date-time toujours présent

Erreurs

• 400

  Saisie refusée

  invalid_idinvalid_body
• 401

  Non authentifié

• 403

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

PUT /modules/{id}/crop

cURL JavaScript Python

curl -X PUT https://api.hub.akuasense.com/v1/modules/1/crop \
  -H "x-api-key: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "cropId": 75,
    "plantingDate": "2022-02-25"
  }'

const response = await fetch(
  'https://api.hub.akuasense.com/v1/modules/1/crop',
  {
    method: 'PUT',
    headers: {
      'x-api-key': 'VOTRE_CLE_API',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      "cropId": 75,
      "plantingDate": "2022-02-25"
    }),
  },
);
const data = await response.json();

import requests

response = requests.put(
    "https://api.hub.akuasense.com/v1/modules/1/crop",
    headers={"x-api-key": "VOTRE_CLE_API"},
    json={
        "cropId": 75,
        "plantingDate": "2022-02-25",
    },
)
data = response.json()

Réponse

201 400 401 403

{
  "success": true,
  "row": {
    "id": 29,
    "timestamp_start": "2026-08-25T17:41:03.111Z"
  }
}

application/json

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

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