L’API de correspondance

Vérifiez des personnes, des sociétés, des organisations et des navires par rapport à nos collections, avec un score et une explication pour chaque résultat.

L’API de correspondance compare les parties que vous connaissez (clients, fournisseurs, contreparties, navires) à chaque fiche d’une collection et renvoie les plus proches, avec un score et une explication. Pour commencer :

Démarrage rapide : une première requête en cURL, Python ou Node.
La requête : collections, filtres, schéma et propriétés.
La réponse : scores, explications et champs des résultats.
L’API des entités : la fiche complète derrière un résultat.

Bâtir un processus de vérification avec l’API de correspondance

La vérification n’est pas une recherche de texte. Un nom seul correspond à de nombreuses personnes; l’outil de correspondance pondère le nom avec la date de naissance, la nationalité ou le pays, le numéro IMO et le type d’entité, de sorte que la partie visée remonte et que les homonymes reculent.

Étape 1 : décrivez vos parties selon nos termes

Associez vos propres colonnes à une requête : le nom complet (et tout autre nom) à name, la date de naissance à birthDate, la nationalité, la résidence ou le pays d’immatriculation à nationality ou country sous forme de codes à deux lettres, et le numéro IMO à imoNumber. Choisissez le schéma selon le type de client.

{
  "schema": "Person",
  "properties": {
    "name": ["Maria Example", "Maria Ejemplo"],
    "birthDate": ["1971-05"],
    "nationality": ["ve", "es"]
  }
}

Chaque propriété est une liste; envoyez donc tous les noms et toutes les nationalités que vous détenez. Convertissez les noms de pays en codes ISO avant l’envoi; l’outil de correspondance ne compare que des codes.

Étape 2 : choisissez où chercher

Commencez par default, qui contient toutes les listes que nous publions. Si vos obligations sont plus restreintes, utilisez sanctions, peps, crime ou maritime, ou conservez default et filtrez avec topics et include_dataset. Consultez Délimitation de la portée.

Étape 3 : envoyez des lots

Envoyez jusqu’à 20 parties par requête, chacune sous votre propre clé, et conservez l’heure de checked_at, les scores et les explications avec vos dossiers. Le démarrage rapide contient du code fonctionnel.

Comprendre les résultats

Chaque résultat correspond à la fiche d’un registre. topics et list_type indiquent le type de liste, programme désigne le programme ou le fondement juridique, et datasets désigne le registre. Récupérez la fiche à partir de l’API des entités pour obtenir chaque inscription et chaque autre registre qui nomme la même partie, ou ouvrez sa page à partir de url.

Réduire les fausses alertes

Envoyez les dates de naissance, les nationalités et les numéros IMO chaque fois que vous les détenez.
Ne vérifiez que les listes dont vous avez besoin, au moyen de la collection et des filtres.
Réglez le seuil selon votre appétit pour le risque et examinez tout ce qui le dépasse; consultez Réglage.
Consignez la raison pour laquelle chaque alerte a été levée, afin que la même fiche n’exige pas un nouvel examen la prochaine fois.

Réconciliation pour OpenRefine

Le même outil de correspondance est offert comme service de réconciliation : ajoutez https://api.crownintelligence.net/api/reconcile/default (ou toute autre collection) dans OpenRefine pour apparier une colonne de tableur, avec jusqu’à 20 requêtes par lot. Consultez la référence.

Exécuter vous-même l’outil de correspondance

À venir : indiquer si nous offrons un déploiement sur site ou autohébergé du service de correspondance, et à quelles conditions.

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