API Publique

Accédez programmatiquement aux données de qualité de l'eau potable française et européenne via notre API REST gratuite et ouverte.

API gratuite et ouverte

Notre API permet aux développeurs, chercheurs, journalistes et citoyens d'accéder facilement aux données officielles de qualité de l'eau potable. Toutes les données sont issues des sources gouvernementales et mises à jour quotidiennement.

Gratuit

Aucun coût

Open Data

Données ouvertes

RESTful

API REST standard

Authentification

L'API est actuellement en accès libre sans authentification pour faciliter l'adoption. Une clé API pourra être requise dans le futur pour des usages intensifs.

URL de base:

https://api.infoeau.fr

Points d'accès disponibles

GET

/api/v1/water-quality/{commune}

Obtenir les données de qualité de l'eau pour une commune

Paramètres:

commune

string

Requis

Code INSEE ou nom de la commune

Exemple:

https://api.infoeau.fr/v1/water-quality/75001

GET

/api/v1/pollutants/{region}

Lister les polluants détectés dans une région

Paramètres:

region

string

Requis

Code région

limit

number

Nombre de résultats (défaut: 100)

Exemple:

https://api.infoeau.fr/v1/pollutants/11?limit=50

GET

/api/v1/alerts

Récupérer les alertes sanitaires en cours

Paramètres:

type

string

Type d'alerte

since

date

Date de début (ISO 8601)

Exemple:

https://api.infoeau.fr/v1/alerts?type=sanitaire

GET

/api/v1/networks

Informations sur les réseaux de distribution

Paramètres:

department

string

Code département

operator

string

Nom de l'opérateur

Exemple:

https://api.infoeau.fr/v1/networks?department=75

GET

/api/v1/eu/water-quality/{country}

Données de qualité de l'eau pour un pays européen

Paramètres:

country

string

Requis

Code pays ISO 2 lettres

Exemple:

https://api.infoeau.fr/v1/eu/water-quality/DE

GET

/api/v1/eu/pollutants

Liste des polluants européens avec moyennes et dépassements par pays

Paramètres:

category

string

Catégorie (Chimique, Métaux lourds...)

Exemple:

https://api.infoeau.fr/v1/eu/pollutants?category=Chimique%20émergent

GET

/api/v1/eu/pollutants/{country}

Polluants détaillés pour un pays européen spécifique

Paramètres:

country

string

Requis

Code pays ISO 2 lettres

Exemple:

https://api.infoeau.fr/v1/eu/pollutants/FR

Exemple de réponse

Toutes les réponses sont au format JSON avec une structure cohérente:

{
  "status": "success",
  "data": {
    "commune": {
      "code": "75001",
      "name": "Paris 1er Arrondissement",
      "population": 16888
    },
    "network": {
      "name": "Réseau Paris Centre",
      "operator": "Eau de Paris",
      "source_type": "Eau de surface traitée"
    },
    "last_analysis": "2024-12-15",
    "quality_indicators": {
      "microbiological_compliance": 100,
      "chemical_compliance": 98.5,
      "risk_level": "low"
    },
    "detected_pollutants": [
      {
        "name": "Nitrates",
        "value": 12.5,
        "unit": "mg/L",
        "limit": 50,
        "status": "compliant"
      }
    ]
  }
}

Limites et conditions d'usage

Limites techniques:

1000 requêtes par heure par adresse IP
Réponses limitées à 1000 enregistrements par requête
Timeout de 30 secondes maximum

Conditions d'utilisation:

Usage respectueux des ressources serveur
Attribution de la source (InfoEau.fr) recommandée
Pas d'usage commercial sans autorisation
Respect de la vie privée et du RGPD

Explorez nos services

Carte des eaux

Explorez la qualité de l'eau dans votre région

Diagnostic

Analysez la qualité de votre eau locale

Quelle eau boire ?

Trouvez l'eau qui vous convient