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 :

• Les modifications listées sont de trois types : 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)

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

Réponses

200

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

text/csv

Réponsestring

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

HTTPcURLJavaScriptPython

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

action,rnb_id,status,sys_period,point,shape,addresses_id,ext_ids

Contenu du fichier CSV

Téléchargez le fichier ci-dessous pour obtenir un exemple de fichier de différentiel.

La description des champs est disponible sur cette page.

779KB

RNB-exemple-differentiel.csv