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 deleteLes modifications sont triées par date de modification croissanteIl 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