Introduction
Cette API permet d’accéder aux données de conformité et aux résultats d’analyses de l’eau potable par commune.
Base URL :
https://api-cieau.breedgital.com:4005/api
Toutes les réponses sont au format JSON.
Authentification
Toutes les routes de l’API sont sécurisées et nécessitent une authentification via un Bearer Token.
Header requis
Authorization: Bearer <VOTRE_TOKEN>
Exemple de requête
GET /conformities Authorization: Bearer eyJhbGciOi...
Toute requête sans token valide retournera une erreur 401 Unauthorized.
1. Taux de conformité
GET /conformities
Retourne le taux de conformité global ainsi que la date de la dernière mise à jour.
Réponse
{
"standard": {
"taux_conformite": 95.5,
"last_date": "2026-01-04"
}
}
Champs
| Champ | Type | Description |
|---|---|---|
| standard.taux_conformite | number | Taux de conformité en pourcentage |
| standard.last_date | string (YYYY-MM-DD) | Date de la dernière mise à jour |
2. Nouvelles communes avec PLV
GET /new/plv
Retourne la liste des communes disposant de nouveaux prélèvements (PLV).
Réponse
[
{
"DATE": "2026-01-09",
"INSEE": "43018",
"POSTAL": "43370"
}
]
Champs
| Champ | Type | Description |
|---|---|---|
| DATE | string | Date du prélèvement |
| INSEE | string | Code INSEE de la commune |
| POSTAL | string | Code postal |
3. Résultats des analyses par commune
GET /plv/{insee}
Retourne les informations de la commune et l’historique des résultats d’analyses physico-chimiques et bactériologiques.
Paramètre
| Nom | Type | Description |
|---|---|---|
| insee | string | Code INSEE de la commune |
Exemple de requête
GET /plv/52062
Structure de la réponse
- commune : informations sur la commune
- bacterio : indicateur bactériologique (0 = conforme, 1 = non conforme)
- dernier_plv_date : date du dernier prélèvement
- resultats : résultats par paramètre (NO3, PH, CA, etc.)
Réponse
{
"commune": {
"POSTAL": "52200",
"INSEE": "52062",
"NAME": "Bourg"
},
"bacterio": 1,
"dernier_plv_date": "2025-09-17",
"resultats": {
"NO3": {
"params": {
"SISE": "NO3",
"REF": "",
"unite": "mg/L"
},
"values": [
{
"date": "2026-01-07",
"value": 49
},
{
"date": "2025-09-17",
"value": 47
},
{
"date": "2025-06-25",
"value": 51
},
{
"date": "2025-05-22",
"value": 50
},
{
"date": "2025-02-13",
"value": 46
},
{
"date": "2024-07-17",
"value": 50
},
{
"date": "2024-05-07",
"value": 59
},
{
"date": "2024-02-22",
"value": 35
},
{
"date": "2023-12-27",
"value": 62
},
{
"date": "2023-11-08",
"value": 75
},
{
"date": "2022-11-17",
"value": 55
}
]
},
"CA": {
"params": {
"SISE": "CA",
"REF": "",
"unite": "mg/L"
},
"values": [
{
"date": "2025-09-17",
"value": 120
},
{
"date": "2025-05-22",
"value": 120
}
]
},
"MG": {
"params": {
"SISE": "MG",
"REF": "",
"unite": "mg/L"
},
"values": [
{
"date": "2025-09-17",
"value": 4.4
},
{
"date": "2025-05-22",
"value": 4.4
}
]
},
"PH": {
"params": {
"SISE": "PH",
"REF": "",
"unite": "unité pH"
},
"values": [
{
"date": "2025-09-17",
"value": 7.5
},
{
"date": "2025-06-25",
"value": 7.2
},
{
"date": "2025-05-22",
"value": 7.5
},
{
"date": "2025-02-13",
"value": 7.5
},
{
"date": "2024-07-17",
"value": 7.42
},
{
"date": "2024-05-07",
"value": 7.47
},
{
"date": "2024-02-22",
"value": 7.95
},
{
"date": "2023-12-27",
"value": 7.6
},
{
"date": "2023-11-08",
"value": 7.46
}
]
},
"SO4": {
"params": {
"SISE": "SO4",
"REF": "",
"unite": "mg/L"
},
"values": [
{
"date": "2025-09-17",
"value": 13
},
{
"date": "2025-05-22",
"value": 13
},
{
"date": "2024-05-07",
"value": 14
},
{
"date": "2023-11-08",
"value": 15
}
]
},
"CL2TOT": {
"params": {
"SISE": "CL2TOT",
"REF": "",
"unite": "mg(Cl2)/L"
},
"values": [
{
"date": "2025-09-17",
"value": 1.24
},
{
"date": "2025-06-25",
"value": 1.4
},
{
"date": "2025-05-22",
"value": 1.17
},
{
"date": "2025-02-13",
"value": 0.3
},
{
"date": "2024-07-17",
"value": 0.19
},
{
"date": "2024-05-07",
"value": 0.04
},
{
"date": "2024-02-22",
"value": 0.21
},
{
"date": "2023-12-27",
"value": 0.26
},
{
"date": "2023-11-08",
"value": 0
}
]
},
"TH": {
"params": {
"SISE": "TH",
"REF": "",
"unite": "°f"
},
"values": [
{
"date": "2025-09-17",
"value": 31.7
},
{
"date": "2025-05-22",
"value": 31.4
},
{
"date": "2024-05-07",
"value": 30.2
},
{
"date": "2023-11-08",
"value": 33.28
}
]
}
}
}