Série pondérée root-zone

GET /modules/{id}/measurements/weighted

Scope readings: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

type string

Grandeur à lire. tensio : sonde tensiométrique — tension, son ancien code, reste accepté. Un module qui n’a qu’un type de capteur sert celui-là, quel que soit le type demandé.

Valeurs : humiditytemperaturetensio

Par défaut : humidity
start string date-time
end string date-time
interval integer

Bucket (secondes)

Réponse

200

Série pondérée root-zone

module_id integer toujours présent
type string toujours présent

Type réellement servi (voir DepthSeries).

Valeurs : humiditytemperaturetensio
unit string toujours présent

Unité de la grandeur principale : % (value_vwc, value_vwc_max), °C (value_temp) ou kPa (value_tensio). value_mm est toujours en mm.
start string date-time toujours présent
end string date-time toujours présent
interval_seconds integer peut être null toujours présent

Voir DepthSeries.
data tableau de WeightedSeriesPoint toujours présent

Un instant de la série pondérée. Seuls les champs du type servi sont présents ; valeurs au dixième. Codes d’erreur des capteurs : voir la description générale de l’API.
Afficher les 6 attributs Masquer les attributs
- time string date-time toujours présent
- value_vwc number peut être null
  
  Humidité moyenne, %, pondérée comme la courbe de synthèse du hub : poids par profondeur saisis dans les Réglages de la sonde, sinon répartition FAO-56 du prélèvement racinaire (40/30/20/10 par quart de la zone racinaire), sinon moyenne simple.
- value_vwc_max number peut être null
  
  La même moyenne, rapportée au maximum que le sol peut retenir, %.
- value_mm number peut être null
  
  Stock d’eau, mm : l’eau contenue dans la zone racinaire déclarée (culture ou profondeur manuelle), sinon dans la colonne suivie par la sonde. Chaque capteur y pèse l’épaisseur de sa tranche de sol, pas son poids de prélèvement : le chiffre se compare donc directement à une pluie ou à un apport d’irrigation. Une tranche sans valeur à cet instant est estimée d’après les autres. null sur une sonde à un seul capteur sans zone racinaire déclarée.
- value_temp number peut être null
  
  Série de température : moyenne pondérée, °C.
- value_tensio number peut être null
  
  Sonde tensiométrique : moyenne pondérée, kPa.

Erreurs

400
Paramètre invalide

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

GET /modules/{id}/measurements/weighted

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

const response = await fetch(
  'https://api.hub.akuasense.com/v1/modules/1/measurements/weighted',
  {
    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/measurements/weighted",
    headers={"x-api-key": "VOTRE_CLE_API"},
)
data = response.json()

Réponse

{
  "module_id": 256,
  "type": "humidity",
  "unit": "%",
  "start": "2026-09-11T19:00:00.000Z",
  "end": "2026-09-11T21:00:00.000Z",
  "interval_seconds": 3600,
  "data": [
    {
      "time": "2026-09-11T19:00:00.000Z",
      "value_vwc": 8.7,
      "value_vwc_max": 18.9,
      "value_mm": 82.5
    },
    {
      "time": "2026-09-11T20:00:00.000Z",
      "value_vwc": 8.8,
      "value_vwc_max": 18.9,
      "value_mm": 82.7
    }
  ]
}

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