Retourne les représentations disponibles fournies par l'observatoireGET
Point d'entrée principal pour la recherche d'indicateurs/objectifs. Retourne la liste des paramètres, datasets, objectifs selon différents niveaux de filtres sur un territoire donné
Documentation détaillée de cet endpoint (paramètres, exemples)
URLs
GET /api/v1/obs_searches
GET /api/v2/obs_searches
Paramètres
| Nom | Dans | Type | Requis | Description |
|---|---|---|---|---|
id_territoire | query | integer | oui | Identifiant du territoire |
ids_datasets | query | string | non | Prioritaire * : Recherche par identifiant de dataset, si plusieurs séparer par des virgules. Ne rien mettre si recherche dans liste par initulé de dataset. |
names_obsdatasets | query | array<enum: string> | non | Recherche par utitulé de dataset (non prioritaire par rapport à ids_datasets). Si plusieurs, séparés par des vigules |
search_entry_ids_parameters | query | string | non | Prioritaire * : Recherche par Ids de parametres, si plusieurs séparer par ds virgules. Ne rien mettre si recherche dans le nom du parametre. |
search_entry_parameter_string_part | query | string | non | recherche dans le nom du parametre (minimum 3 caractères). pour utiliser ce parametre Recherche par Ids de parametres doit être vide |
string_part_search_limit | query | integer | non | Limiter les résultats de la recherche libre à n paramètres par jeu de données (valeur max 10) |
Exemple — Recherche paramètres/objectifs (dataset sans fragment)
Sans fragment de recherche : premiers paramètres du dataset (search_limit) — source des listes de choix paramètre/objectif du front.
GET /api/v2/obs_searches.json?id_territoire=1&ids_datasets=qualite_eaux_surf_support_eau&search_limit=10
[
{
"id_parametre": 7597,
"parametre": "10,11-dihydro-10,11-dihydroxy-carbamazépine",
"unite": "µg/L",
"dataset": "qualite_eaux_surf_support_eau",
"obsDatasetMetadata": {
"title": "Qualité des eaux superficielles (support eau brute) - Hub'eau (Naïades)",
"history": {
"lastUpdate": "2026-09-10"
},
"sources": [
{
"producers": [
{
"producer_url": "",
"producer_logo": "",
"producer_name": "AE"
}
],
"source_url": "https://hubeau.eaufrance.fr/page/api-qualite-cours-deau",
"source_logo": "/images/icones/hubeau-api-quality.svg",
"source_name": "hubeau, Qualité des cours d'eau"
}
],
"descripteur": "AR",
"description": "osur pc paramètre seulement sur le support eau brute"
},
"ids_objectifs": []
},
{
"id_parametre": 7947,
"parametre": "10:2 FTCA",
"unite": "µg/L",
"dataset": "qualite_eaux_surf_support_eau",
"obsDatasetMetadata": {
"title": "Qualité des eaux superficielles (support eau brute) - Hub'eau (Naïades)",
"history": {
"lastUpdate": "2026-09-10"
},
"sources": [
{
"producers": [
{
"producer_url": "",
"producer_logo": "",
"producer_name": "AE"
}
],
"source_url": "https://hubeau.eaufrance.fr/page/api-qualite-cours-deau",
"source_logo": "/images/icones/hubeau-api-quality.svg",
"source_name": "hubeau, Qualité des cours d'eau"
}
],
"descripteur": "AR",
"description": "osur pc paramètre seulement sur le support eau brute"
},
"ids_objectifs": [
{
"id_conf_objectif": "9974",
"value": "0.007",
"inf_sup": "<=",
"reference": "PFAS TEST 0.007",
"objectiveCompliancyFunction": "100PourcentDuTemps",
"default_args": [],
"processing": "respect-objectif"
}
]
},
{
"id_parametre": 8003
… (réponse tronquée)Exemple — Recherche paramètres/objectifs (dataset fragment "phosph")
Recherche les paramètres dont le nom contient le fragment « phosph » pour le dataset : source des listes de choix paramètre/objectif du front.
GET /api/v2/obs_searches.json?id_territoire=1&search_entry_parameter_string_part=phosph&ids_datasets=qualite_eaux_surf_support_eau&search_limit=10
[
{
"id_parametre": 1238,
"parametre": "Phosphamidon",
"unite": "µg/L",
"dataset": "qualite_eaux_surf_support_eau",
"obsDatasetMetadata": {
"title": "Qualité des eaux superficielles (support eau brute) - Hub'eau (Naïades)",
"history": {
"lastUpdate": "2026-09-10"
},
"sources": [
{
"producers": [
{
"producer_url": "",
"producer_logo": "",
"producer_name": "AE"
}
],
"source_url": "https://hubeau.eaufrance.fr/page/api-qualite-cours-deau",
"source_logo": "/images/icones/hubeau-api-quality.svg",
"source_name": "hubeau, Qualité des cours d'eau"
}
],
"descripteur": "AR",
"description": "osur pc paramètre seulement sur le support eau brute"
},
"ids_objectifs": [
{
"id_conf_objectif": "11498",
"value": "0.1",
"inf_sup": "<=",
"reference": "SAGE SN 2015",
"objectiveCompliancyFunction": "100PourcentDuTemps",
"default_args": [],
"processing": "respect-objectif"
}
]
},
{
"id_parametre": 7834,
"parametre": "Gomphosphaeria",
"unite": null,
"dataset": "qualite_eaux_surf_support_eau",
"obsDatasetMetadata": {
"title": "Qualité des eaux superficielles (support eau brute) - Hub'eau (Naïades)",
"history": {
"lastUpdate": "2026-09-10"
},
"sources": [
{
"producers": [
{
"producer_url": "",
"producer_logo": "",
"producer_name": "AE"
}
],
"source_url": "https://hubeau.eaufrance.fr/page/api-qualite-cours-deau",
"source_logo": "/images/icones/hubeau-api-quality.svg",
"source_name": "hubeau, Qualité des cours d'eau"
}
],
"descripteur": "AR",
"description": "osur pc paramètre seulement sur le support eau brute"
},
"ids_objectifs": []
},
{
"id_parametre": 1349,
"parametre": "Polyphos
… (réponse tronquée)