Cultures (code+label)

GET /reference/crops

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

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

Catalogue des cultures, trié sur le nom français quelle que soit lang

• data tableau de CropReference toujours présent

  Une culture du catalogue partagé. root_depth_min_cm et root_depth_max_cm ne décrivent PAS une croissance racinaire (un départ et une arrivée) : ce sont les deux bornes d’une même profondeur MAXIMALE, qui dépend du sol.

  Afficher les 5 attributs Masquer les attributs

  • code string toujours présent

    Identifiant stable de la culture. C’est la valeur à passer, en entier, dans cropId de PUT /modules/{id}/crop.

  • label string toujours présent

    Nom de la culture dans la langue demandée (lang). Sans traduction anglaise, retombe sur le nom français.

  • scientific_name string peut être null toujours présent

    Nom scientifique. null si non renseigné.

  • root_depth_min_cm number toujours présent

    Profondeur racinaire maximale en sol LOURD, en cm — la borne basse de la fourchette FAO-56. C’est elle que le hub retient pour piloter l’irrigation, constante sur tout le cycle.

  • root_depth_max_cm number toujours présent

    Profondeur racinaire maximale en sol LÉGER, en cm — la borne haute. FAO-56 la réserve à la modélisation du stress hydrique et aux cultures pluviales.

Erreurs

• 401

  Non authentifié

• 403

  Scope insuffisant ou ressource hors société

GET /reference/crops

cURL JavaScript Python

curl https://api.hub.akuasense.com/v1/reference/crops \
  -H "x-api-key: VOTRE_CLE_API"

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

import requests

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

Réponse

200 401 403

{
  "data": [
    {
      "code": "31",
      "label": "Avocado",
      "scientific_name": "Persea americana",
      "root_depth_min_cm": 50,
      "root_depth_max_cm": 100
    },
    {
      "code": "32",
      "label": "Gold kiwifruit",
      "scientific_name": "Actinidia chinensis",
      "root_depth_min_cm": 70,
      "root_depth_max_cm": 130
    },
    {
      "code": "26",
      "label": "Temporary grassland",
      "scientific_name": null,
      "root_depth_min_cm": 60,
      "root_depth_max_cm": 100
    },
    {
      "code": "24",
      "label": "Grapevine (wine grape)",
      "scientific_name": "Vitis vinifera",
      "root_depth_min_cm": 100,
      "root_depth_max_cm": 200
    }
  ]
}

application/json

{
  "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