Documentation · Modèle de données

Politique de modification

Notre modèle de données, nos fichiers et notre API évolueront au fil de l’ajout de sources et de champs. Cette page explique ce que nous annonçons, où nous l’annonçons et comment concevoir une intégration qui continue de fonctionner lorsque les choses changent.

Pourquoi les choses changent

La plupart des modifications ajoutent quelque chose : une nouvelle source, une nouvelle propriété dès que nous pouvons l’analyser, un nouveau format de fichier. Certaines suppriment ou renomment des éléments : une source qui cesse de publier, une propriété remplacée par une meilleure, un point d’accès repensé. Les suppressions et les changements de nom sont ceux qui peuvent perturber une intégration; c’est donc l’objet de la présente politique.

Ce que couvre le journal des modifications

Le journal des modifications consigne les changements apportés au modèle de données, aux fichiers de métadonnées, aux formats de téléchargement et à l’API, ainsi que le retrait de sources. Les nouvelles sources n’y sont pas annoncées une à une; elles figurent dans Toutes les sources de données et dans le sources.json de chaque collection.

Préavis avant les suppressions et les changements de nom

Composant	Ajouts	Suppressions et changements de nom
Modèle de données (schémas, propriétés, sujets)	Sans préavis	À confirmer
Fichiers de métadonnées (`index.json`, `sources.json`, catalogue)	Sans préavis	À confirmer
Sources et collections	Sans préavis	À confirmer (une source peut aussi disparaître lorsque son éditeur cesse de la publier ou retire son autorisation)
API	Sans préavis	À confirmer
Formats de téléchargement et colonnes	Sans préavis	À confirmer

À fournir : le délai de préavis pour chacune des suppressions ou chacun des changements de nom ci-dessus, et s’il diffère pour les clients ayant un contrat. Ces engagements envers les clients nécessitent une décision du responsable, conformément à la section 11 des conditions.

Concevoir une intégration durable

Ignorez ce que vous ne connaissez pas. Lisez les champs et les propriétés dont vous avez besoin et laissez le reste de côté, afin que les nouvelles propriétés, les nouveaux champs dans index.json et les nouvelles collections ne perturbent pas votre code.
Ne vous appuyez pas sur une liste fixe de sources. Traitez datasets et sources.json comme des listes ouvertes.
Vérifiez la version. Comparez le version de chaque collection dans le catalogue avant le téléchargement, et vérifiez les fichiers à l’aide de leurs sommes de contrôle SHA-256.
Conservez les identifiants des fiches, et non les noms. Consultez la conservation des références.
Lisez le journal des modifications avant de mettre à niveau tout élément qui analyse nos fichiers.

Pour suivre les modifications dans un lecteur de flux, abonnez-vous au flux RSS du journal des modifications (/estate/changelog/rss.xml). Il contient les mêmes entrées que la page du journal des modifications.

Questions et commentaires

Écrivez à [email protected] au sujet d’une modification qui vous touche, ou consultez Obtenir de l’aide.

À fournir : si nous mettrons en place un canal communautaire (forum ou clavardage) pour les intégrateurs.

Dernière mise à jour : 2026-10-04