fr_act  en_desact
 

API Référentiel

L'API référentiel * permet d'accéder à tous les objets - sans leurs géométries - des référentiels * Sandre. Vous trouverez dans les formulaires ci-dessous la liste des référentiels * de cette API.

Cette API est RESTful c'est-à-dire qu'elle respecte les préconisations de l'architecture REST. Le point d'accès à cette API (endpoint) est :

https://api.sandre.eaufrance.fr/referentiels/v1/

Les interfaces ci-dessous vous aident à construire et à exécuter votre requête sur ces référentiels * . Ces interfaces sont inutiles si vous êtes capables de formuler votre requête selon les modèles expliqués ci-dessous. Les URI d'appel de l'API sont toujours composées du endpoint suivi du nom ou code du référentiel * à interroger. Les référentiels * utilisables proviennent des mnémoniques de la nomenclature * sandre 373 .

Par exemple, l'adresse https://api.sandre.eaufrance.fr/referentiels/v1/appeltaxon vous permet d'extraire toute ou partie du référentiel * * des appellations de taxon.

NB : Pour information * , cette API remplace l'ancienne interface de service web référentiel.

Utilisez un des formulaires pour découvrir le service et vous aider à contruire votre requête:

Télécharger un référentiel

Cette opération vous permet le téléchargement d'un référentiel Sandre.
Modèle:

https://api.sandre.eaufrance.fr/referentiels/v1/[référentiel]{.format}?{outputSchema=schéma}&{compress=true}&{filter=filtre}&{derniereDateDeMAJ=date}&{limit=limite}&{offset=offset}

Les éléments entre [] sont obligatoires.
Les éléments entre {} sont facultatifs.
Formulaire de construction:
https://api.sandre.eaufrance.fr/referentiels/v1/
.
Par ex., 2024-10-11

Télécharger un élément d'un référentiel

Cette opération vous permet le téléchargement d'un élément de référentiel.
Modèle:

https://api.sandre.eaufrance.fr/referentiels/v1/[référentiel]/[code d'un élément]{.format}?{outputSchema=schéma}&{compress=true}

Les éléments entre [] sont obligatoires.
Les éléments entre {} sont facultatifs.
Formulaire de construction:
https://api.sandre.eaufrance.fr/referentiels/v1/
/
.

Télécharger les métadonnées d'un référentiel

Cette opération vous permet le téléchargement des métadonnées d'un référentiel (date de mise à jour, nombre d'éléments...).
Modèle:

https://api.sandre.eaufrance.fr/referentiels/v1/[référentiel]/meta{.format}?{outputSchema=schéma}&{derniereDateDeMAJ=date}

Les éléments entre [] sont obligatoires.
Les éléments entre {} sont facultatifs.
Formulaire de construction:
https://api.sandre.eaufrance.fr/referentiels/v1/
/meta
.
Par ex., 2024-10-11

Télécharger l'historique d'un référentiel

Cette opération vous permet le téléchargement des données historique d'un référentiel.
Note: la date de révision est facultative, si laissée vide vous obtiendrez la liste des différentes dates de mises à jour.
Modèle:

https://api.sandre.eaufrance.fr/referentiels/v1/[référentiel]/history{/date de la révision}{.format}?{outputSchema=schéma}

Les éléments entre [] sont obligatoires.
Les éléments entre {} sont facultatifs.
Formulaire de construction:
https://api.sandre.eaufrance.fr/referentiels/v1/
/history
/
Par ex., 2024-10-11
.
Haut