Qu'est ce que l'API ADS du RNB ?
L'API ADS permet aux instructeurs des Droits du Sol d'ajouter des informations sur un bâtiment existant (ex : Démoli) ou de créer un nouveau bâtiment au sein du RNB.
Une fois vos ADS ajoutées sur le RNB, l’ensemble de vos nouvelles informations bâtimentaires pourront ainsi être accessibles par tous les services de votre collectivité.
Accès réservé
L’API dédiée aux Autorisations du Droit des Sols (ADS) est réservée aux communes.
Identification
Toutes les requêtes liées aux ADS doivent faire l’objet d’une authentification. Pour vous identifier, utilisez le token fourni par l’équipe du RNB. Pour faire une demande de token, .
Ajoutez une clé Authorization aux headers HTTP de chacune de vos requêtes. La valeur doit être votre token préfixé de la chaîne “Token”. Un espace sépare “Token” et votre token.
NB : n’oubliez pas le slash à la fin des endpoints
Endpoint de création
POST https://rnb-api.beta.gouv.fr/api/alpha/ads/
Endpoint de modification
PUT https://rnb-api.beta.gouv.fr/api/alpha/ads/[file_number]/
Requête
Les requêtes de création et de modification sont identiques. Seuls l’URL des endpoints et la méthode HTTP diffèrent.
Détails d'une requête
Paramètre
Format
Commentaire
file_number
string
Requis. Doit être unique. N° de dossier de l’ADS. Au format “PC333802300001”.
decided_at
AAA-MM-DD
Requis. Date d’acceptation de l’ADS par l’instructeur.
buildings_operations
array
Requis. Liste des constructions, modifications et démolition de bâtiments liées à cette ADS. Voir tableau ci-dessous pour le détail d’un élément de cette liste.
Détails des éléments contenus dans buildings_operations :
Paramètre
Format
Commentaire
operation
string parmi choix restreint
Requis. Valeurs possibles :
build (construction neuve)
modify (modification d’un bâtiment existant)
demolish (démolition complète)
rnb_id
string
Optionnel. Doit être un ID-RNB existant dans le RNB.
ID-RNB du bâtiment (ex : ABCD1234WXYZ) → l’ADS concerne un bâtiment déjà présent dans le RNB
shape
géométrie geojson (SRID 4326)
Une géométrie représentant le bâtiment.
Exemples
Exemple : création d’une ADS liée à un bâtiment présent dans le RNB
//////////////////
// Requête
//////////////////
{
"file_number": "PCXXXXXXXXXX",
"decided_at": "2019-03-18",
"buildings_operations": [
{
"operation": "demolish",
"rnb_id": "ABCD1234WXYZ", // Pour un bâtiment connu du RNB, indiquez son rnb_id
}
],
}
//////////////////
// Réponse
//////////////////
{
"file_number": "PCXXXXXXXXXX",
"decided_at": "2019-03-18",
"buildings_operations": [
{
"operation": "build",
"rnb_id": "ABCD1234WXYZ",
"shape": null
}
],
}
Exemple : création d’une ADS liée à deux bâtiments dont on ne connait pas l'identifiant RNB