État hydrique (saturé/confort/stress + FC/PWP)

GET /modules/{id}/agronomic-state

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

Paramètres de chemin

id integer obligatoire

Réponse

200

État hydrique au dernier relevé

state string peut être null toujours présent

saturated : à la capacité au champ ou au-dessus. comfort : entre les deux seuils. stress : sous le point de flétrissement. null : aucune mesure, pas assez de seuils pour situer la valeur, ou capteur en défaut (sensorError).

Valeurs : saturatedcomfortstress
value number peut être null toujours présent

Humidité de la courbe de synthèse au dernier relevé, %, au dixième. null : aucune mesure, ou capteur en défaut (sensorError).
fieldCapacity number peut être null toujours présent

Seuil de capacité au champ tracé sur la courbe, %. null : non tracé.
wiltingPoint number peut être null toujours présent

Seuil de point de flétrissement tracé sur la courbe, %. null : non tracé.
sensorError boolean toujours présent

true : un capteur pris dans la moyenne (humidité, ou température qui la corrige) renvoie un code d’erreur au dernier relevé. La valeur serait fausse : state et value valent alors null. Ne rien recommander tant qu’il reste true.

Erreurs

400
Paramètre invalide

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

GET /modules/{id}/agronomic-state

curl https://api.hub.akuasense.com/v1/modules/1/agronomic-state \
  -H "x-api-key: VOTRE_CLE_API"

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

import requests

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

Réponse

{
  "state": "comfort",
  "value": 16.7,
  "fieldCapacity": 27.7,
  "wiltingPoint": 11,
  "sensorError": false
}

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