API REST para acceder a los datos hídricos en tiempo real — estrés hídrico, riesgos, cumplimiento.
Todas las solicitudes deben incluir su clave API en el encabezado Authorization.
Authorization: Bearer aqsig_YOUR_API_KEY
Plan Enterprise requerido
Las claves API están disponibles únicamente para cuentas Enterprise. Ver los planes →
Base URL
https://aquasignal.frGestionar sus claves API
Genere, liste y revoque sus claves en Configuración → API
| Plan | Solicitudes / minuto | Solicitudes / día |
|---|---|---|
| Enterprise | 120 | 50 000 |
/api/v1/stressEstrés hídrico por départementDevuelve el índice de estrés hídrico (0-5) y el nivel de alerta para los départements franceses.
Parámetros
deptstringopcionalCódigo département (ej: 13, 34). Si está ausente, devuelve todos los départements.Ejemplo cURL
curl -X GET "https://aquasignal.fr/api/v1/stress?dept=13" \ -H "Authorization: Bearer aqsig_YOUR_API_KEY"
Respuesta
{
"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 riesgo hídrico por départementDevuelve los scores de riesgo de inundación, sequía y global (0-100) con rating SURGE.
Parámetros
deptstringopcionalCódigo département. Si está ausente, devuelve todos los départements.Ejemplo cURL
curl -X GET "https://aquasignal.fr/api/v1/risque?dept=34" \ -H "Authorization: Bearer aqsig_YOUR_API_KEY"
Respuesta
{
"dept": "34",
"name": "Hérault",
"flood": 65,
"drought": 86,
"overall": 80,
"rating": "B",
"updatedAt": "2026-03-25T08:00:00.000Z"
}/api/v1/hydroriskHistorial SURGE™Devuelve el historial de análisis SURGE™ de su cuenta.
Parámetros
limitintegeropcionalNúmero de resultados (máx. 100, por defecto 20)offsetintegeropcionalDesplazamiento para paginación (por defecto 0)Ejemplo cURL
curl -X GET "https://aquasignal.fr/api/v1/hydrorisk?limit=10" \ -H "Authorization: Bearer aqsig_YOUR_API_KEY"
Respuesta
{
"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/conformiteHistorial Auditoría Hídrica 360°Devuelve el historial de auditorías hídricas de cumplimiento de su cuenta.
Parámetros
limitintegeropcionalNúmero de resultados (máx. 100, por defecto 20)offsetintegeropcionalDesplazamiento para paginación (por defecto 0)Ejemplo cURL
curl -X GET "https://aquasignal.fr/api/v1/conformite" \ -H "Authorization: Bearer aqsig_YOUR_API_KEY"
Respuesta
{
"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"])| Código | Significado |
|---|---|
401 | Clave API ausente o inválida |
403 | Plan insuficiente (Enterprise requerido) |
404 | Recurso no encontrado |
429 | Límite de frecuencia excedido |
500 | Error interno del servidor |