API publique & conditions d'utilisation
L'Observatoire des ABC propose une API publique en lecture seule pour permettre aux sites tiers, aux collectivités et aux chercheurs de réutiliser les données — y compris les corrections et ajouts des contributeurs — en créditant la source. Toutes les données sont réutilisables sous Licence Ouverte 2.0 (Etalab).
Endpoints (v1)
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /api/v1/projets | Liste des projets, paginée par curseur. Filtres : statut, annee, code_insee, departement, region, porteur, bbox. GeoJSON possible. |
| GET | /api/v1/projets/{id} | Fiche détaillée d'un projet : communes, vérification, historique, provenance. |
| GET | /api/v1/communes/{code_insee} | Fiche d'une commune et projets liés. GeoJSON possible. |
| GET | /api/v1/departements/{code} | Synthèse d'un département : communes et projets couverts. |
| GET | /api/v1/regions/{code} | Synthèse d'une région (slug, code INSEE ou libellé). |
| GET | /api/v1/journal | Journal public d'audit : vérifications, contributions validées, fusions — dans le même ordre que sur le site. |
| GET | /api/v1/stats | Compteurs globaux : projets, communes, vérifications, anomalies. |
| GET | /api/v1/communes/{code_insee}/patrimoine | Patrimoine écologique INPN de la commune : ZNIEFF, sites Natura 2000 et aires protégées, avec attribution MNHN. |
| GET | /api/v1/patrimoine/znieff | Liste des ZNIEFF touchant au moins une commune ABC (100 par page). |
| GET | /api/v1/patrimoine/znieff/{id_national} | Fiche ZNIEFF : intérêt, communes ABC concernées, espèces déterminantes (hors confidentielles). |
| GET | /api/v1/patrimoine/natura | Liste des sites Natura 2000 touchant au moins une commune ABC (100 par page). |
| GET | /api/v1/patrimoine/natura/{sitecode} | Fiche Natura 2000 : habitats, espèces de la directive, DOCOB, communes ABC concernées. |
Réponses en JSON par défaut ; /api/v1/projets et /api/v1/communes/{code_insee} acceptent aussi le GeoJSON (paramètre format=geojson ou en-tête Accept: application/geo+json). La pagination est par curseur : suivez meta.next_cursor ou meta.next_page_url. Chaque enregistrement expose ses métadonnées de provenance (source_origine, licence, derniere_mise_a_jour, enrichi_par_contributeurs, statut_verification).
Documentation interactive (OpenAPI)Spécification OpenAPI (YAML)
Licence et crédit attendu
Les données de l'API sont sous Licence Ouverte 2.0 (Etalab) : réutilisation libre, y compris commerciale, sous réserve de créditer la source. La mention de crédit attendue, prête à copier :
Source : Observatoire des ABC (observatoire-abc.fr), enrichi par ses contributeurs, d'après les données de l'OFB et du Fonds vert — sous Licence Ouverte Etalab 2.0. Mise à jour : 17/11/2026.
Cette mention ne doit ni conférer un caractère officiel à votre réutilisation, ni suggérer un cautionnement par l'Observatoire des ABC, l'OFB ou le Fonds vert.
Les corrections des contributeurs sont intégrées aux données publiées sous cette même licence : chaque proposition l'accepte explicitement (case du formulaire de correction, acceptation enregistrée), avec un crédit collectif — jamais nominatif.
Patrimoine INPN : les endpoints /api/v1/communes/{code_insee}/patrimoine et /api/v1/patrimoine/… exposent des faits bruts de l'INPN, qui ne sont pas couverts par la Licence Ouverte de l'Observatoire : chaque réponse porte son attribution (Muséum national d'Histoire naturelle, licences de l'INPN) et la version de référence des bases utilisées. Les espèces confidentielles ne sont jamais diffusées.
Absence de garantie
Les données sont fournies « en l'état », sans garantie d'exactitude, de complétude, d'actualité ni de disponibilité. L'Observatoire agrège des registres publics et le travail de contributeurs bénévoles : les statuts affichés incluent des estimations (un ABC dure environ trois ans). Croisez toujours avec les sources officielles avant toute décision.
Limites d'usage
- Accès ouvert, sans clé : 60 requêtes/minute par IP (au-delà : HTTP 429).
- Chaque réponse GET porte
ETagetCache-Control: renvoyezIf-None-Matchpour recevoir des304et alléger vos requêtes. - Les réponses sont mises en cache une heure : une correction validée peut mettre jusqu'à une heure à apparaître (invalidation immédiate côté collecte et vérification).
- CORS ouvert : l'API est interrogeable depuis un navigateur tiers.
- Aucune donnée personnelle n'est exposée : les contributions sont créditées collectivement (« les contributeurs de l'Observatoire des ABC »), jamais nominativement.
Versionnement
L'API est versionnée : tout vit sous /api/v1 et aucun breaking change n'interviendra dans une version publiée. Les ajouts de champs (non destructifs) restent possibles en v1 ; les évolutions incompatibles, s'il en faut, arriveront en v2 avec une période de transition annoncée.