Téléchargement et maintien à jour des données

Les fichiers en bloc se trouvent à des adresses fixes et ne nécessitent aucune connexion. Cette page explique le format des adresses, comment savoir qu’une nouvelle version est publiée, comment vérifier un téléchargement et comment garder votre copie à jour.

Adresses de téléchargement

Chaque fichier de chaque collection a une adresse unique, qui diffuse toujours la dernière version :

/downloads/collections/<collection>/<file>

# examples
/downloads/collections/default/entities.ftm.json
/downloads/collections/sanctions/targets.simple.csv
/downloads/collections/maritime/index.json

Collections : default, sanctions, peps, crime, maritime. Les fichiers sont énumérés dans Formats de données. Le catalogue de toutes les collections se trouve à /downloads/collections/index.json.

BASE=https://crownintelligence.net     # the public download host; see the note below
curl -O "$BASE/downloads/collections/sanctions/targets.simple.csv"

À venir : le nom d’hôte public pour les téléchargements (dans cet aperçu, les fichiers sont servis depuis le même hôte que le site, sous /downloads/).

Données historiques

Chaque adresse est écrasée par la version suivante. Nous ne conservons pas encore de copies datées des versions antérieures; les chiffres de chaque version passée sont conservés dans le fichier statistics.json de chaque collection, et les modifications des versions récentes dans son fichier deltas.json (voir Fichiers delta).

À venir : si nous conserverons des versions datées, à quelle adresse, pendant combien de temps et à quelles conditions.

Fréquence de modification des données

Deux cadences comptent :

Registres. Chaque registre source est collecté selon son propre calendrier, adapté à la fréquence de mise à jour de son éditeur. L’intervalle d’actualisation de chaque registre d’une collection figure dans son fichier sources.json (cadence_hours); la page Fraîcheur en fait la synthèse.
Versions en bloc. Les fichiers sont reconstruits à partir du registre par lots. Les versions actuelles figurent ci-dessous.

Collection	Version	Version du	Dernier traitement des données
`default`	`—`	—	—
`sanctions`	`—`	—	—
`peps`	`—`	—	—
`crime`	`—`	—	—
`maritime`	`—`	—	—

La mention « Dernier traitement des données » correspond à la date de confirmation la plus récente de toute fiche de la version. Une nouvelle version de données inchangées reçoit un nouveau numéro de version, mais conserve la même date de données.

À venir : le calendrier de reconstruction des fichiers en bloc (par exemple, après chaque cycle d’actualisation des registres). D’ici là, consultez index.json plutôt que de supposer un intervalle fixe.

Synchroniser votre copie

Choisissez l’une des trois méthodes, de la plus simple à la plus efficace.

1. Tout télécharger de nouveau

Récupérez les fichiers que vous utilisez selon un calendrier et remplacez votre copie. Méthode simple et robuste, mais elle consomme de la bande passante pour les grandes collections (par défaut entities.ftm.json : —).

2. Interroger l’index, télécharger en cas de changement

Récupérez le petit fichier index.json de la collection, comparez son champ version (ou le champ sha256 d’un fichier) à ce que vous avez enregistré, et ne téléchargez que si les valeurs diffèrent.

#!/bin/sh
# download targets.simple.csv when a new build is out
BASE=https://crownintelligence.net; C=sanctions; F=targets.simple.csv
NEW=$(curl -s "$BASE/downloads/collections/$C/index.json" | jq -r --arg f "$F" '.files[] | select(.name==$f) | .sha256')
OLD=$(cat "$F.sha256" 2>/dev/null)
if [ "$NEW" != "$OLD" ]; then
  curl -s -o "$F.part" "$BASE/downloads/collections/$C/$F"
  echo "$NEW  $F.part" | shasum -a 256 -c - && mv "$F.part" "$F" && echo "$NEW" > "$F.sha256"
fi

3. Appliquer les deltas

Téléchargez une première fois, puis appliquez les modifications de chaque version à partir de deltas.json. Idéal pour les grandes collections et les magasins de données de longue durée. Voir Fichiers delta.

Vérifier un téléchargement

La somme de contrôle SHA-256, la taille et le nombre de lignes de chaque fichier figurent dans le fichier index.json de sa collection. Comparez-les avant de remplacer votre copie :

shasum -a 256 targets.simple.csv          # macOS, Linux
certutil -hashfile targets.simple.csv SHA256   # Windows

Les fichiers sont écrits sous un nom temporaire, puis substitués une fois complets; un téléchargement ne tombe donc jamais sur un fichier partiellement écrit. Si vous récupérez index.json et un fichier de données de part et d’autre d’un changement de version, la somme de contrôle ne correspondra pas : récupérez de nouveau l’index et réessayez.

Suppressions, fusions et changements d’identifiant

Suivez les fiches par id (crown-<number>). Une fiche absente d’une nouvelle version a quitté la collection : supprimez-la de votre copie. Les fichiers delta l’indiquent par des opérations DEL.
Les fiches que nous avons associées à une même partie partagent un canonical_id. Cet identifiant peut apparaître, changer ou disparaître d’une version à l’autre à mesure que l’appariement s’améliore; ne l’utilisez donc pas comme clé permanente.
referents est toujours vide actuellement; il énumérera les identifiants fusionnés dans une fiche dès que nous publierons des entités fusionnées.

À venir : notre politique de stabilité des identifiants de fiche et le préavis donné avant un changement de format.

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