Différentiel entre deux dates

Tous nos points d'accès acceptent un paramètre optionnel supplémentaire from qui vous permet de renseigner une adresse mail. Celle-ci nous permettra de vous prévenir en cas de changement sur l'un des endpoints qui vous utilisez.

Par exemple : https://rnb-api.beta.gouv.fr/api/alpha/buildings/?from=[e-mail]

Différences depuis une date donnée

get

Liste l'ensemble des modifications apportées au RNB depuis une date données. Génère un fichier CSV. Voici les points importants à retenir :

• La colonne action correspond à l'action à mener sur une base local pour la garder synchronisée avec le RNB. Il existe 3 types d'actions : create, update et delete

• Les modifications sont triées par date de modification croissante

• Il est possible qu'un même bâtiment ait plusieurs modifications dans la période considérée. Par exemple, une création (create) suivie d'une mise à jour (update)

• La colonne event_type correspond à l'opération réalisée sur le bâtiment (création, désactivation, mise à jour, fusion, scission)

Par exemple, une fusion de deux bâtiments fera apparaître 3 lignes qui partageront la même action (merge) et le même event_id. Les deux bâtiments parents auront l'action delete tandis que le bâtiment enfant aura l'action create.Voici un exemple de requête permettant d'obtenir les modifications du RNB ayant eu lieu depuis une date déterminée : https://rnb-api.beta.gouv.fr/api/alpha/buildings/diff/?since=2026-02-23 14:11:34.870172+00:00

Paramètres de requête

sincestringRequis

Date et heure à partir de laquelle les modifications sont retournées. Le format est ISO 8601. Seules les dates après le 1er avril 2024 sont acceptées.Une date antérieure reviendrait à télécharger l'intégralité de la base de données (l'ensemble de la base est disponible ici).

Example: 2024-04-02T00:00:00Z

insee_codestringOptionnel

Code INSEE de la commune pour filtrer les modifications du RNB. Seules les modifications de bâtiments dont la géométrie intersecte la commune seront retournées. Le code INSEE est composé de 5 caractères.

Example: 75056

Réponses

200

Fichier CSV listant l'ensemble des opérations ayant modifié le RNB depuis la date indiquée.

text/csv

stringOptionnel

400

Requête invalide (données mal formatées ou incomplètes).

429

Le quota de requêtes a été atteint. Un quota maximal de 20 requêtes par secondes est appliqué, mais celui-ci peut varier par requête. Veuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota.

get

/api/alpha/buildings/diff/

HTTPcURLJavaScriptPython

GET /api/alpha/buildings/diff/?since=text HTTP/1.1
Host: rnb-api.beta.gouv.fr
Accept: */*

action,rnb_id,status,is_active,sys_period,point,shape,addresses_id,ext_ids,parent_buildings,event_id,event_type,username

La description des champs est disponible sur cette page.