LogoLogo
Site du RNBGithub
  • Documentation du Référentiel National du Bâtiment (RNB)
  • API et Outils
    • 🛍️Liste des API et outils du RNB
    • 🗺️Tuiles vectorielles
    • 🏨API Bâtiments
      • Consultation d'un bâtiment
      • Listing de bâtiments
      • Identification de bâtiment
      • Différentiel entre deux dates
      • Éditer le RNB
        • Guide d'édition du RNB
    • 🏗️API ADS
    • 🏙️Export national et départemental
    • 🏖️Bac à sable
  • Exemples
    • 🗃️Obtenir des attributs métier à partir d'un identifiant RNB (ID-RNB)
    • 🏪Sélecteur de bâtiments
  • Lexique et définitions
    • 📐Propriétés d'un bâtiment
      • Parcelles cadastrales
  • 📝Lexique du RNB
  • 🪡Cycle de vie de la donnée
  • A propos
    • 🪙Budget
  • 📞Contacter le RNB
Propulsé par GitBook
Sur cette page
  • Accès réservé
  • Identification
  • Liste et recherche d'ADS
  • Endpoint
  • Filtres de recherche
  • Exemple de réponse
  • Création et modification d'une ADS
  • Endpoints
  • Requête
  • Exemples
  • Suppression d’une ADS
  • Endpoint

Cet article vous a-t-il été utile ?

  1. API et Outils

API ADS

PrécédentGuide d'édition du RNBSuivantExport national et départemental

Dernière mise à jour il y a 2 mois

Cet article vous a-t-il été utile ?

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.

Authorization: Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b

Liste et recherche d'ADS

Endpoint

GET https://rnb-api.beta.gouv.fr/api/alpha/ads/

Filtres de recherche

Les filtres de recherche sont à transmettre sous forme de paramètres d’url.

Exemple
GET https://rnb-api.beta.gouv.fr/api/alpha/ads/?since=2023-01-01

Détails des filtres disponibles

Paramètre
Format
Défaut
Commentaire

q

string

null

Recherche parmi les n° de dossiers (propriété file_number). Accepte les n° de dossier incomplets. Insensible à la casse.

since

AAA-MM-DD

null

Récupère tous les dossiers dont la propriété decided_at est supérieure ou égale à la valeur demandée.

Exemple de réponse

{
    "count": 3,
    "next": null,
    "previous": null,
    "results": [
        {
            "file_number": "TEST03818519U9999",
            "decided_at": "2023-06-01",
            "buildings_operations": [
                {
                    "rnb_id": "A1B2C3A1B2C3",
                    "shape": null,
                    "operation": "build"
                },
                {
                    "rnb_id": null,
                    "shape": {
                        "type": "Point",
                        "coordinates": [
                            5.722961565015281,
                            45.1851103238598
                        ]
                    }
                    "operation": "demolish"
                },
                {

                    "rnb_id": "1M2N3O1M2N3O",
                    "shape": {
                        "type": "Point",
                        "coordinates": [
                            5.723006573148693,
                            45.1851402293713
                        ]
                    },
                    "operation": "demolish"
                }
            ]
        },
        {
            "file_number": "PC3807123200WW",
            "decided_at": "2023-05-01",
            "buildings_operations": [
                {
                    "rnb_id": "FXFJZNZYGTED",
                    "shape": null
                    "operation": "build"
                }
            ]
        },
        {
            "file_number": "PC384712301337",
            "decided_at": "2023-02-22",
            "buildings_operations": [
                {
                    "rnb_id": "RXNOSN2DUCLG",
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            5.775791408470412,
                            45.256939624268206
                        ]
                    }
                    "operation": "modify"
                }
            ]
        }, 
    ]
}

Création et modification d'une ADS

Endpoints

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

//////////////////
// Requête
//////////////////
{
	"file_number": "PCXXXXXXXXXX",
	"decided_at": "2019-03-18",
	"buildings_operations": [
	    {
	        "operation": "build",
	        "shape": {
	            "type": "Point",
	            "coordinates": [2.3552747458487002, 48.86958288638419],
	        }
	    },
	    {
	        "operation": "build",
                "shape": {
                    "type": "Point",
                    "coordinates": [2.3547872809558203, 48.86945119575674],
                },
	    },
	],
}

//////////////////
// Réponse
//////////////////
{
	"file_number": "PCXXXXXXXXXX",
	"decided_at": "2019-03-18",
	"buildings_operations": [
	    {
	        "operation": "build",
                "rnb_id": null,
                "shape": {
                    "type": "Point",
                    "coordinates": [2.3552747458487002, 48.86958288638419],
                }
	    },
	    {
	        "operation": "build",
	        "rnb_id": null,
	        "shape": {
	            "type": "Point",
	            "coordinates": [2.3547872809558203, 48.86945119575674],
	         },	 
	    },
	],
}

Exemple : création d’une ADS concernant la démolition d’un bâtiment connu du RNB et la construction d’un nouveau bâtiment absent du RNB

//////////////////
// Requête
//////////////////
{
	"file_number": "PCXXXXXXXXXX",
	"decided_at": "2019-03-10",
	"buildings_operations": [
	    {
	        "operation": "demolish",
	        "rnb_id": "7865HG43PLS9", // Destruction du bâtiment existant, déjà connu par le RNB
	    },
	    {
	        "operation": "build",
                "shape": {
                    "type": "Point",
                    "coordinates": [2.3552747458487002, 48.86958288638419],
                },
	    }
	],
}

//////////////////
// Réponse
//////////////////
{
	"file_number": "PCXXXXXXXXXX",
	"decided_at": "2019-03-10",
	"buildings_operations": [
	    {
	        "operation": "demolish",
	        "rnb_id": "7865HG43PLS9", 
	        "shape": null
	    },
	    {
	        "operation": "build",
	        "rnb_id": null, 
                "shape": {
                    "type": "Point",
                    "coordinates": [2.3552747458487002, 48.86958288638419],
                },
	    }
	],
}

Suppression d’une ADS

Endpoint

DELETE https://rnb-api.beta.gouv.fr/api/alpha/ads/[file_number]/

🏗️
Faire une demande d'accès ->
renseignez ce formulaire