Ajouter une API de consultation d'un territoire GET /territoires/{idTerritoire}
Pre requis : faire évoluer la génération des territoires par crater-data pour pouvoir récupérer les hierarchies de territoires, voir cette issue crater-data#5 (closed)
On peut magré tout débuter ces évolutions sans attendre crater-data en anticipant le fichier résultat territoires.csv dans les données de tests de crater-api
Les opérations du groupe "API Territoires" (cf. le tag correspondant dans la spec open api) contiennent pour l'instant des opérations de recherche des communes. Dans un objectif de généraliser la recherche et l'affichage d'un résultat pour tous les niveaux de territoires, il faut ajouter des opérations équivalentes pour le territoire.
Une issue précédante concernait la recherche (voir #8 (closed)), afin d'alimenter l'ui avec un résultat de recherche et de permettre la selection d'un idTerritoire.
Cette issue concerne la récupération la description d'un territoire à partir de son id.
La requete est la suivante : GET /territoires/{idTerritoire}
La réponse a la forme suivante (voir détails des champs présents ou pas selon le type de territoire)
{
"idTerritoire": "C-52360",
"categorieTerritoire": "COMMUNE",
"nomTerritoire": "Occey",
"pays": {
"id": "string",
"nom": "string"
},
"region": {
"id": "string",
"nom": "string"
},
"departement": {
"id": "string",
"nom": "string"
},
"epci": {
"id": "string",
"nom": "string",
}
}
- Si le territoire est un EPCI : la réponse ne contient pas l'objet epci
- Si le territoire est un département : la réponse ne contient pas les objets epci et département
- Si le territoire est une région : la réponse ne contient pas les objets epci et département et région
- Si le territoire est un pays : la réponse ne contient pas les objets epci et département et région et pays