API et webhooks
Une API et des webhooks faciles à utiliser pour vos données d'humidité du sol
SoilSense vous donne un accès programmatique complet à vos données de sol via une API REST documentée et des webhooks en temps réel — pour que cela fonctionne avec les logiciels agricoles, les tableaux de bord et les automatisations que vous utilisez déjà.
Vos données, comme vous voulez
Vos mesures ne sont pas obligées de rester enfermées dans une application. Avec l'API et les webhooks de SoilSense, chaque mesure recueillie par vos capteurs vous appartient : à vous de la récupérer, de l'envoyer et de la combiner avec le reste de votre exploitation — sans export CSV manuel et sans dépendance.
API REST
Lisez chaque mesure avec une API REST simple
Authentifiez-vous avec une clé API personnelle et lisez vos exploitations, vos sites d'observation et tout l'historique des mesures au format JSON propre.
# the latest reading for a site
curl https://api.app.soilsense.io/api/site/{siteId}/observations/latest \
-H "x-api-key: $SOILSENSE_API_KEY"
# 200 OK
{
"timestamp": 1640995200000,
"rssi": -75,
"data": { "top": {
"volumetricWaterContent": 25.5,
"temperature": 18.5,
"plantAvailableWater": 75.2,
"salinity": 0.45
} }
}Toutes vos données de sol
Teneur en eau volumétrique, température, salinité et eau disponible pour les plantes à chaque profondeur, ainsi que la pluie des pluviomètres connectés.
Exploitations, sites et historique
Listez vos exploitations et vos sites d'observation, lisez leur configuration et interrogez l'historique des mesures sur n'importe quelle période.
La dernière mesure, instantanément
Récupérez l'observation la plus récente de n'importe quel site en une seule requête — idéal pour les tableaux de bord en direct et les vérifications rapides.
Webhooks
Les webhooks en temps réel vous envoient les données
Au lieu d'interroger le système en boucle, laissez SoilSense envoyer les données à votre endpoint au moment même où elles arrivent.
Webhooks de télémétrie
Les nouvelles mesures des capteurs sont envoyées à votre endpoint en temps réel, prêtes pour votre base de données, votre tableau de bord ou votre régulateur d'irrigation.
Webhooks d'attributs
Soyez averti à chaque fois qu'un site d'observation est créé ou modifié, afin que vos propres enregistrements restent synchronisés automatiquement.
Signés et sécurisés
Chaque webhook peut être vérifié avec une signature HMAC-SHA256 facultative, pour avoir la certitude que chaque requête provient bien de SoilSense.
// pushed from SoilSense the moment it arrives
{
"ts": 1640995200000,
"values": {
"volumetricWaterContent_top": 25.5,
"plantAvailableWater_top": 75.2,
"irrigationStatus": "ok"
}
}
// verify with the signature header
SoilSense-Signature: t=…,v1=<hmac-sha256>Ce que vous pouvez construire
Connectez SoilSense aux outils que vous utilisez déjà
Logiciel de gestion agricole
Intégrez l'humidité du sol et l'eau disponible pour les plantes dans la plateforme où vous planifiez déjà l'irrigation.
Irrigation automatisée
Déclenchez ou ajustez les régulateurs d'irrigation à partir des mesures en direct et des alertes d'assèchement.
BI et reporting
Alimentez tableaux de bord, feuilles de calcul et rapports pour la comptabilité de l'usage de l'eau et la conformité.
Alertes et automatisations sur mesure
Acheminez les mesures vers votre propre pipeline de notifications, d'automatisation ou d'analyse.
API et webhooks — questions fréquentes
L'essentiel pour connecter SoilSense à vos propres systèmes.
Commencez à développer avec l'API SoilSense
Référence complète, endpoints et exemples — tout ce qu'il vous faut pour connecter SoilSense à vos systèmes.
Lire la documentation de l'APIExplorer le système
Discutons-en
Vous voulez intégrer SoilSense ?
Dites-nous ce que vous souhaitez connecter et nous vous aiderons à tirer le meilleur parti de l'API et des webhooks.
Sans engagement · Nous vous répondons dès que possible
Ou restez informé
Des nouvelles ponctuelles sur nos nouveautés produit et les dernières technologies agricoles.