Série par profondeur

GET /modules/{id}/measurements

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)
raw boolean

true : chaque mesure, sans moyenne par intervalle, calibrée une à une. Au plus 100 000 relevés (un par profondeur et par instant), les plus anciens d’abord : au-delà, la FIN de la période manque — découpez-la. Défaut : moyennes par intervalle.

Par défaut : false

Réponse

200

Série par profondeur

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

Type RÉELLEMENT servi : un module qui n’a qu’un type de capteur rend celui-là, quel que soit type demandé (un tensiomètre interrogé en humidité rend tensio).

Valeurs : humiditytemperaturetensio
unit string toujours présent

Unité de la grandeur principale : % en humidité (_vwc, _vwc_max), °C en température (_temp), kPa pour une sonde tensiométrique (_tensio). depthN_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

Intervalle demandé. null : intervalle automatique, environ 60 points sur la période et jamais moins de 5 minutes — ou série non moyennée (raw=true).
data tableau de DepthSeriesPoint toujours présent

Un instant : time, puis des clés par profondeur N, en cm, chacune nommée d’après sa grandeur. Humidité : depthN_vwc, depthN_vwc_max, depthN_mm, depthN_ru_percent. Température : depthN_temp. Tensiomètre : depthN_tensio. Valeurs au dixième. Une profondeur sans valeur calibrée à cet instant est simplement absente. Codes d’erreur des capteurs : voir la description générale de l’API.
Afficher l'attribut Masquer les attributs
- time string date-time toujours présent

Erreurs

400
Paramètre invalide

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

GET /modules/{id}/measurements

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

const response = await fetch(
  'https://api.hub.akuasense.com/v1/modules/1/measurements',
  {
    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",
    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",
      "depth0_vwc": 10.8,
      "depth0_vwc_max": 23.3,
      "depth0_mm": 5.4,
      "depth0_ru_percent": 100,
      "depth15_vwc": 8.1,
      "depth15_vwc_max": 17.5,
      "depth15_mm": 14.1,
      "depth15_ru_percent": 63.5,
      "depth30_vwc": 9.4,
      "depth30_vwc_max": 20.3,
      "depth30_mm": 14.1,
      "depth30_ru_percent": 90.3,
      "depth45_vwc": 11.5,
      "depth45_vwc_max": 25,
      "depth45_mm": 17.3,
      "depth45_ru_percent": 100,
      "depth60_vwc": 6.6,
      "depth60_vwc_max": 14.4,
      "depth60_mm": 10,
      "depth60_ru_percent": 33.9
    },
    {
      "time": "2026-09-11T20:00:00.000Z",
      "depth0_vwc": 10.9,
      "depth0_vwc_max": 23.6,
      "depth0_mm": 5.4,
      "depth0_ru_percent": 100,
      "depth15_vwc": 8.1,
      "depth15_vwc_max": 17.5,
      "depth15_mm": 14.1,
      "depth15_ru_percent": 63.1,
      "depth30_vwc": 9.4,
      "depth30_vwc_max": 20.3,
      "depth30_mm": 14.1,
      "depth30_ru_percent": 90.3,
      "depth45_vwc": 11.5,
      "depth45_vwc_max": 25,
      "depth45_mm": 17.3,
      "depth45_ru_percent": 100,
      "depth60_vwc": 6.7,
      "depth60_vwc_max": 14.4,
      "depth60_mm": 10,
      "depth60_ru_percent": 34.5
    }
  ]
}

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