API REST pour accéder aux données eau en temps réel — stress hydrique, risques, conformité.
Toutes les requêtes doivent inclure votre clé API dans le header Authorization.
Authorization: Bearer aqsig_YOUR_API_KEY
Plan Enterprise requis
Les clés API sont disponibles pour les comptes Enterprise uniquement. Voir les plans →
Base URL
https://aquasignal.frGérer vos clés API
Générez, listez et révoquez vos clés dans Paramètres → API
| Plan | Requêtes / minute | Requêtes / jour |
|---|---|---|
| Enterprise | 120 | 50 000 |
/api/v1/stressStress hydrique par départementRetourne l'indice de stress hydrique (0-5) et le niveau d'alerte pour les départements français.
Paramètres
deptstringoptionnelCode département (ex: 13, 34). Si absent, retourne tous les départements.Exemple cURL
curl -X GET "https://aquasignal.fr/api/v1/stress?dept=13" \ -H "Authorization: Bearer aqsig_YOUR_API_KEY"
Réponse
{
"count": 96,
"updatedAt": "2026-03-25T08:00:00.000Z",
"data": [
{
"dept": "13",
"name": "Bouches-du-Rhône",
"stressIndex": 4.5,
"level": "crise"
}
]
}/api/v1/risqueScore de risque eau par départementRetourne les scores de risque inondation, sécheresse et global (0-100) avec rating SURGE.
Paramètres
deptstringoptionnelCode département. Si absent, retourne tous les départements.Exemple cURL
curl -X GET "https://aquasignal.fr/api/v1/risque?dept=34" \ -H "Authorization: Bearer aqsig_YOUR_API_KEY"
Réponse
{
"dept": "34",
"name": "Hérault",
"flood": 65,
"drought": 86,
"overall": 80,
"rating": "B",
"updatedAt": "2026-03-25T08:00:00.000Z"
}/api/v1/hydroriskHistorique SURGE™Retourne l'historique des analyses SURGE™ de votre compte.
Paramètres
limitintegeroptionnelNombre de résultats (max 100, défaut 20)offsetintegeroptionnelDécalage pour pagination (défaut 0)Exemple cURL
curl -X GET "https://aquasignal.fr/api/v1/hydrorisk?limit=10" \ -H "Authorization: Bearer aqsig_YOUR_API_KEY"
Réponse
{
"total": 12,
"limit": 20,
"offset": 0,
"data": [
{
"id": "clx...",
"companyName": "Acme SAS",
"sectorCode": "C10",
"deptCode": "34",
"globalScore": 62.4,
"rating": "BB",
"createdAt": "2026-03-20T10:30:00.000Z"
}
]
}/api/v1/conformiteHistorique Audit Eau 360°Retourne l'historique des audits eau de conformité de votre compte.
Paramètres
limitintegeroptionnelNombre de résultats (max 100, défaut 20)offsetintegeroptionnelDécalage pour pagination (défaut 0)Exemple cURL
curl -X GET "https://aquasignal.fr/api/v1/conformite" \ -H "Authorization: Bearer aqsig_YOUR_API_KEY"
Réponse
{
"total": 5,
"limit": 20,
"offset": 0,
"data": [
{
"id": "clx...",
"companyName": "Industrie Eau SA",
"sectorCode": "C17",
"deptCode": "69",
"score": 71.5,
"globalRating": "A",
"createdAt": "2026-03-15T14:00:00.000Z"
}
]
}JavaScript / Node.js
const res = await fetch("https://aquasignal.fr/api/v1/stress?dept=13", {
headers: {
"Authorization": "Bearer aqsig_YOUR_API_KEY",
"Content-Type": "application/json"
}
});
const data = await res.json();
console.log(data.stressIndex, data.level);Python
import requests
headers = {"Authorization": "Bearer aqsig_YOUR_API_KEY"}
r = requests.get(
"https://aquasignal.fr/api/v1/stress",
params={"dept": "34"},
headers=headers
)
data = r.json()
print(data["stressIndex"], data["level"])| Code | Signification |
|---|---|
401 | Clé API manquante ou invalide |
403 | Plan insuffisant (Enterprise requis) |
404 | Ressource non trouvée |
429 | Limite de débit dépassée |
500 | Erreur serveur interne |