Culture en cours

GET /modules/{id}/crop

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

Paramètres de chemin

id integer obligatoire

Paramètres de requête

lang string

Langue des label, et du nom par défaut d’une sonde (name : « Probe 3 », « Sonde 3 »). Les code ne varient jamais. Une culture sans traduction retombe sur son nom français.

Valeurs : enfr

Par défaut : en

Réponse

200

Culture active, ou null si rien n’est déclaré

id integer toujours présent

Identifiant de la déclaration.
module_id integer toujours présent
crop_id integer peut être null toujours présent

Culture : code de GET /reference/crops. null en mode manuel.
planting_date string date-time peut être null toujours présent

Date de plantation ou de semis : un jour, rendu à minuit UTC. null en mode manuel.
manual_zr_cm number peut être null toujours présent

Profondeur racinaire saisie à la main, en cm. null en mode culture.
is_manual boolean toujours présent

true : mode manuel, sans culture.
zr_cap_cm number peut être null toujours présent

Plafond de profondeur racinaire propre au module, en cm (mode culture) : la profondeur retenue devient min(zr_min_cm, zr_cap_cm). null : pas de plafond.
timestamp_start string date-time toujours présent

Date de la déclaration.
notes string peut être null toujours présent
crop_name string peut être null toujours présent

Nom de la culture dans la langue demandée (lang). null en mode manuel.
name_scientific string peut être null toujours présent

Nom scientifique. null en mode manuel, ou si non renseigné.
zr_min_cm number peut être null toujours présent

Profondeur racinaire retenue par le hub, en cm : la borne basse FAO-56 de la culture (root_depth_min_cm du référentiel), ou la profondeur manuelle.
zr_max_cm number peut être null toujours présent

Borne haute FAO-56 de la culture, en cm. En mode manuel, la profondeur manuelle.

Erreurs

400
Paramètre invalide

invalid_id
401
Non authentifié
403
Scope insuffisant ou ressource hors société

GET /modules/{id}/crop

curl https://api.hub.akuasense.com/v1/modules/29/crop \
  -H "x-api-key: VOTRE_CLE_API"

const response = await fetch(
  'https://api.hub.akuasense.com/v1/modules/29/crop',
  {
    headers: {
      'x-api-key': 'VOTRE_CLE_API',
    },
  },
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.hub.akuasense.com/v1/modules/29/crop",
    headers={"x-api-key": "VOTRE_CLE_API"},
)
data = response.json()

Réponse

{
  "id": 29,
  "module_id": 256,
  "crop_id": 75,
  "planting_date": "2022-02-25T00:00:00.000Z",
  "manual_zr_cm": null,
  "is_manual": false,
  "zr_cap_cm": null,
  "timestamp_start": "2026-08-25T17:41:03.111Z",
  "notes": null,
  "crop_name": "Apricot",
  "name_scientific": "Prunus armeniaca",
  "zr_min_cm": 100,
  "zr_max_cm": 200
}

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