Information
- OpenAPI version:
3.1.0
Overview
Akuasense API 1.0.6-module-name
Section intitulée « Akuasense API 1.0.6-module-name »API REST Akuasense — lecture + écriture limitée. Auth par clé API (x-api-key). Données scopées à la société de la clé. Les écritures exigent un rôle OWNER/MANAGER (créateur de la clé) et acceptent Idempotency-Key. Temps ISO 8601 UTC ; mesures avec unit ; référentiels en { code, label }.
Irrigation (depuis 1.0.2) : saisie des apports d’eau à la sonde, réglages versionnés et programmes. Deux points à savoir avant d’intégrer :
- Deux chiffres en millimètres.
waterMmest la dose rapportée à la surface totale — comparable à une pluie, à l’ETc ou au compteur.waterMmWettedest la dose dans la zone humidifiée, là où la sonde est plantée : c’est elle qui explique la hausse d’humidité observée. En goutte-à-goutte le rapport est d’environ 1 à 3. - Les millimètres sont figés à l’écriture, avec le matériel valide à la date de l’arrosage et un cliché des paramètres utilisés. Corriger un débit de goutteur l’an prochain ne réécrira pas l’historique.
La saisie refuse l’incohérent, jamais l’incomplet : un arrosage sans dose calculable est enregistré quand même, waterMm à null, et warnings dit pourquoi.
Codes d’erreur des capteurs (depuis 1.0.4) : un capteur qui ne répond pas enregistre un code à la place d’une mesure. Les séries (/measurements, /measurements/weighted, /measurements/latest, flux /stream, outils MCP) les servent tels quels, sans les écarter ni les signaler. En température, ils se reconnaissent : −50 °C ou moins. En humidité, non : une fois calibrés, ils sortent en valeurs d’apparence normale, ou collées à la saturation (_vwc_max à 100), et peuvent tirer la série pondérée jusqu’à 0. Un code d’humidité tombe presque toujours sur un relevé où la température est elle aussi en erreur au même instant : c’est le repère le plus sûr. L’état hydrique (/agronomic-state) les détecte au dernier relevé : sensorError passe à true, state et value à null.
Unité des annotations (depuis 1.0.5) : sur les courbes d’humidité, une annotation appartient à l’unité dans laquelle elle a été tracée — unit : vwc (défaut), vwc_max ou mm — et ne s’affiche que dans celle-ci. Les annotations existantes sont en vwc. Les seuils agronomiques se posent en vwc : c’est en VWC que l’alerte et l’état hydrique les lisent. Seul le point de flétrissement de la courbe humidity arme une alerte ; sur une autre courbe, il reste un simple repère.
Nom des sondes (depuis 1.0.6) : un module porte name, le nom sous lequel le hub le montre — celui que le client lui a donné, sinon son nom par défaut, « Probe 3 » ou « Sonde 3 » selon lang. Il figure sur /modules, /modules/{id} et sur le module d’une alerte (/alerts). Il se change dans le hub, pas par l’API. Pour retrouver un module d’un appel à l’autre, gardez son id : le nom peut changer, et le nom par défaut suit la langue.
Authentication
Section intitulée « Authentication »apiKeyAuth
Section intitulée « apiKeyAuth »Security scheme type: apiKey
Header parameter name: x-api-key