Partager via

OpenSanctions (Éditeur indépendant) (préversion)

L’API OpenSanctions vous permet de rechercher et d’interroger les sanctions globales et la base de données des personnes exposées politiquement. Il fournit des points de terminaison pour la correspondance d’entités, la recherche de texte, la récupération d’entité et les données au niveau de l’instruction granulaire. Utilisez-le pour vérifier les personnes ou les entreprises contre les listes de sanctions ou explorer le graphique d’entité OpenSanctions.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom OpenSanctions
URL https://developments.substack.com
Messagerie électronique dan.romano@swolcat.com
Métadonnées du connecteur
Éditeur krautrocker
Website https://www.opensanctions.org/
Politique de confidentialité https://www.opensanctions.org/docs/privacy/
Catégories Data

OpenSanctions

Aperçu

L’API OpenSanctions permet d’accéder à une base de données mondiale de personnes et d’entreprises d’intérêt politique, criminel ou économique. Il agrège les données de centaines de listes de sanctions, de personnes exposées politiquement et de watchlists à travers le monde.

Vous pouvez utiliser ce connecteur pour faire correspondre, rechercher et extraire des entités, explorer les relations et analyser la couverture du jeu de données.

En savoir plus sur OpenSanctions.org.

Éditeur - Dan Romano (swolcat)

Prerequisites

Vous aurez besoin d’une clé API à partir d’OpenSanctions pour utiliser ce connecteur. Inscrivez-vous à une clé gratuite à l’adresse suivante : https://www.opensanctions.org/api/

Opérations prises en charge

Mettre en correspondance les entités par jeu de données

Mettre en correspondance les entités en fonction du nom et des champs facultatifs tels que la date de naissance, la nationalité et les identificateurs. Ce point de terminaison prend en charge la correspondance approximative.

Rechercher des entités dans un jeu de données

Rechercher des entités à l’aide d’une requête de texte simple. Prend en charge les filtres, les rubriques, les pays et les jeux de données pour les recherches affinées.

Obtenir une entité par ID

Récupérez un enregistrement d’entité unique par son identificateur unique, y compris les attributs imbriqués et associés.

Obtenir des entités adjacentes

Retourne des entités adjacentes à une entité spécifiée (par exemple, associés, membres de la famille ou sociétés associées).

Obtenir des entités adjacentes par propriété

Retourne des entités associées pour une propriété spécifique (par exemple, familyPerson, propertyOwner, membershipMember).

Obtenir le catalogue de jeux de données

Récupérez la liste de tous les jeux de données indexés disponibles via OpenSanctions.

Obtenir l’intégrité du système

Effectuez un contrôle d’intégrité du système pour vérifier la disponibilité du service.

Obtenir des algorithmes de correspondance

Répertorier les algorithmes de correspondance d’entités pris en charge utilisés par le système.

Forcer la mise à jour d’index

Déclenchez une opération de réindexation si elle est autorisée avec un jeton de mise à jour valide.

Getting Started

  1. Créez un compte à OpenSanctions.org.
  2. Une clé API
  3. Dans Power Automate ou Power Apps, créez une connexion à l’aide de votre clé API.
  4. Utilisez les actions du connecteur pour rechercher, faire correspondre ou extraire des entités.

Obtention des informations d’identification

Visitez https://www.opensanctions.org/api/ cette page pour demander une clé API. Vous recevrez une ApiKey valeur qui doit être utilisée dans l’en-tête Authorization :

Autorisation : ApiKey YOUR_API_KEY

Problèmes connus et limitations

  • Les structures de réponse sont dynamiques ; utilisez « Analyser JSON » dans Power Automate pour accéder aux valeurs imbriquées.
  • Les search points de terminaison et match les points de terminaison peuvent retourner des réponses volumineuses en fonction de l’étendue du jeu de données.
  • Certains points de terminaison nécessitent un paramètre valide dataset (par exemple, sanctions).
  • Le tri par des champs non pris en charge (comme score) peut déclencher des erreurs.
  • Les limites de taux d’API peuvent s’appliquer en fonction de votre plan.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :
Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
Clé API securestring La api_key de cette API Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Faire correspondre des entités à un jeu de données

Utilisez ce point de terminaison pour faire correspondre des personnes ou des entreprises à un jeu de données à l’aide du nom flou, de la date de naissance et des critères de nationalité. Retourne les résultats de correspondance marqués avec des seuils de confiance.
Forcer la régénération des index

Déclenche une reconstruction manuelle de l’index de recherche. Nécessite un jeton de mise à jour valide pour l’autorisation. Utilisez cette option pour actualiser le jeu de données lorsque des modifications de données ou de structure se produisent.
Obtenir des entités adjacentes à une entité

Retourne des entités connectées à l’entité spécifiée, telles que les personnes liées, les entreprises, les identificateurs ou les sanctions. Utile pour explorer les relations de graphe dans le jeu de données OpenSanctions.
Obtenir des instructions d’entité brutes

Retourne des données d’entité granulaires sous forme d’instructions individuelles de la base de données OpenSanctions. Chaque instruction représente un seul fait (par exemple, nom, adresse, date de naissance) extrait des données sources.
Obtenir le catalogue de jeux de données

Retourne le catalogue de services complet contenant tous les jeux de données disponibles et indexés dans l’API OpenSanctions. Utile pour découvrir les noms et les métadonnées du jeu de données.
Obtenir les algorithmes de correspondance pris en charge

Récupère une liste de tous les algorithmes de correspondance et de scoring pris en charge utilisés par l’API pour la comparaison d’entités et le classement des résultats.
Obtenir les entités associées par propriété

Retourne des entités liées à une entité donnée par le biais d’une propriété spécifique, telle que la propriété, les liens familiaux ou les identificateurs. Utile pour explorer les relations de graphe en détail.
Obtenir une entité par ID

Retourne l’enregistrement complet d’une entité spécifiée par son ID, y compris les données associées telles que la propriété, les associations et les propriétés liées.
Rapprocher les entités d’un jeu de données

Fournit un point de terminaison de rapprochement compatible avec l’API Google Refine (OpenRefine). Utilisez-le pour faire correspondre ou vérifier en bloc les noms d’entités sur un jeu de données à partir d’un outil externe tel qu’OpenRefine.
Rechercher des entités dans un jeu de données

Utilisez ce point de terminaison pour rechercher des entités par nom ou mot clé dans un jeu de données. Prend en charge les filtres de champs, les correspondances approximatives et les facettes facultatives.
Vérifier la préparation de l’index de recherche

Retourne l’état de l’index de recherche pour indiquer si l’API est prête à gérer les requêtes. Utile pour surveiller la préparation au démarrage et au déploiement.
Vérifier l’état d’intégrité de l’API

Retourne une réponse d’état simple confirmant que l’API est accessible et opérationnelle. Couramment utilisé par les outils de surveillance ou les sondes d’liveness Kubernetes.

Faire correspondre des entités à un jeu de données

ID d’opération :
Match_match__dataset__post

Utilisez ce point de terminaison pour faire correspondre des personnes ou des entreprises à un jeu de données à l’aide du nom flou, de la date de naissance et des critères de nationalité. Retourne les résultats de correspondance marqués avec des seuils de confiance.

Paramètres

Nom Clé Obligatoire Type Description
Nom du jeu de données cible
 dataset True string

Nom du jeu de données ou de la collection sur lequel exécuter la requête de correspondance.
Limite des résultats
 limit integer

Nombre maximal de correspondances à retourner (1 à 500).
Seuil de correspondance
 threshold double

Score minimal pour inclure un résultat (0 à 1).
Score de coupure
 cutoff double

Score minimal acceptable pour le meilleur découpage de match.
Version de l’algorithme
 algorithm string

Algorithme correspondant à utiliser, par exemple, logic-v1.
Jeux de données inclus
 include_dataset array

Jeux de données à inclure explicitement dans la correspondance.
Schémas exclus
 exclude_schema array

Schémas à exclure du processus de correspondance.
Jeux de données exclus
 exclude_dataset array

Jeux de données à exclure du processus de correspondance.
Filtre rubriques
 topics array

Limitez les correspondances aux entités marquées avec ces rubriques.
Modification depuis la date
 changed_since string

Incluez uniquement les entités modifiées depuis cette date ISO.
ID d’entité exclus
 exclude_entity_ids array

ID d’entité à ignorer pendant la correspondance. Permet de filtrer les faux positifs ou les entités précédemment examinées.
En-tête de type de contenu
 Content-Type string

Type de contenu du corps de la requête (application/json).
Poids
 weights object
config
 config object

Paramètres de configuration spécifiques à l’algorithme.
queries
 queries True object

Retours

EntityMatchResponse
EntityMatchResponse

Forcer la régénération des index

ID d’opération :
Force_update_updatez_post

Déclenche une reconstruction manuelle de l’index de recherche. Nécessite un jeton de mise à jour valide pour l’autorisation. Utilisez cette option pour actualiser le jeu de données lorsque des modifications de données ou de structure se produisent.

Paramètres

Nom Clé Obligatoire Type Description
Jeton de mise à jour
 token string

Jeton d’API requis pour autoriser la reconstruction d’index.
Mode de synchronisation
 sync boolean

Exécutez de manière synchrone et attendez la fin de l’index.

Retours

StatusResponse
StatusResponse

Obtenir des entités adjacentes à une entité

ID d’opération :
Fetch_Adjacent_Entities__entities__entity_id__adjacent_get

Retourne des entités connectées à l’entité spécifiée, telles que les personnes liées, les entreprises, les identificateurs ou les sanctions. Utile pour explorer les relations de graphe dans le jeu de données OpenSanctions.

Paramètres

Nom Clé Obligatoire Type Description
Identifiant d'entité
 entity_id True string

ID unique de l’entité dont les connexions doivent être récupérées.
Ordre de tri
 sort array

Triez les résultats par champ, par exemple, score :desc.
Limite des résultats
 limit integer

Nombre maximal d’entités associées à retourner (1 à 500).
Décalage de résultat
 offset integer

Décalage de départ pour les entités associées paginés.

Retours

response
object

Obtenir des instructions d’entité brutes

ID d’opération :
Statements_statements_get

Retourne des données d’entité granulaires sous forme d’instructions individuelles de la base de données OpenSanctions. Chaque instruction représente un seul fait (par exemple, nom, adresse, date de naissance) extrait des données sources.

Paramètres

Nom Clé Obligatoire Type Description
Nom du jeu de données
 dataset string

Limitez les résultats aux instructions de ce jeu de données.
Identifiant d'entité
 entity_id string

Instructions de retour liées à cet ID d’entité.
ID canonique
 canonical_id string

Instructions Fetch pour l’ID d’entité canonique.
Filtre de propriété
 prop string

Filtrez les instructions par nom de propriété.
Valeur de la propriété
 value string

Instructions de filtre contenant cette valeur de propriété.
Filtre de schéma
 schema string

Restreindre les instructions aux entités d’un schéma donné.
Ordre de tri
 sort array

Triez les résultats par champ, par exemple, timestamp :desc.
Limite des résultats
 limit integer

Nombre maximal d’instructions à retourner (1 à 5 000).
Décalage de résultat
 offset integer

Décalage de départ pour les résultats paginés.

Retours

StatementResponse
StatementResponse

Obtenir le catalogue de jeux de données

ID d’opération :
Catalog_catalog_get

Retourne le catalogue de services complet contenant tous les jeux de données disponibles et indexés dans l’API OpenSanctions. Utile pour découvrir les noms et les métadonnées du jeu de données.

Retours

response
object

Obtenir les algorithmes de correspondance pris en charge

ID d’opération :
Algorithms_algorithms_get

Récupère une liste de tous les algorithmes de correspondance et de scoring pris en charge utilisés par l’API pour la comparaison d’entités et le classement des résultats.

Retours

AlgorithmResponse
AlgorithmResponse

Obtenir les entités associées par propriété

ID d’opération :
Fetch_Adjacent_by_Property__entities__entity_id__adjacent__property_name__get

Retourne des entités liées à une entité donnée par le biais d’une propriété spécifique, telle que la propriété, les liens familiaux ou les identificateurs. Utile pour explorer les relations de graphe en détail.

Paramètres

Nom Clé Obligatoire Type Description
Identifiant d'entité
 entity_id True string

ID unique de l’entité dont les éléments associés à extraire.
Nom de la propriété
 property_name True string

Nom de propriété utilisé pour extraire des entités associées.
Ordre de tri
 sort array

Triez les entités associées par champ, par exemple, score :desc.
Limite des résultats
 limit integer

Nombre maximal d’entités associées à retourner (1 à 500).
Décalage de résultat
 offset integer

Décalage de départ pour les résultats liés paginés.

Retours

Structure JSON dynamique reprentant les entités associées. Chaque propriété peut contenir des tableaux de chaînes ou d’objets d’entité imbriqués.

response
object

Obtenir une entité par ID

ID d’opération :
Fetch_entity_entities__entity_id__get

Retourne l’enregistrement complet d’une entité spécifiée par son ID, y compris les données associées telles que la propriété, les associations et les propriétés liées.

Paramètres

Nom Clé Obligatoire Type Description
Identifiant d'entité
 entity_id True string

ID unique de l’entité à récupérer.
Inclure des entités imbriquées
 nested boolean

Incluez des entités liées ou associées dans la réponse.

Retours

Objet JSON dynamique. Autorise tous les types de champs sans validation.

response
object

Rapprocher les entités d’un jeu de données

ID d’opération :
Reconcile_reconcile__dataset__get

Fournit un point de terminaison de rapprochement compatible avec l’API Google Refine (OpenRefine). Utilisez-le pour faire correspondre ou vérifier en bloc les noms d’entités sur un jeu de données à partir d’un outil externe tel qu’OpenRefine.

Paramètres

Nom Clé Obligatoire Type Description
Jeu de données cible
 dataset True string

Nom du jeu de données ou de la collection à rapprocher.

Retours

FreebaseManifest
FreebaseManifest

Rechercher des entités dans un jeu de données

ID d’opération :
Search_search__dataset__get

Utilisez ce point de terminaison pour rechercher des entités par nom ou mot clé dans un jeu de données. Prend en charge les filtres de champs, les correspondances approximatives et les facettes facultatives.

Paramètres

Nom Clé Obligatoire Type Description
Jeu de données cible
 dataset True string

Jeu de données ou collection dans laquelle effectuer une recherche.
Requête de recherche
 q string

Texte à rechercher, tel qu’un nom ou un mot clé.
Filtre de schéma
 schema string

Limitez les résultats à un schéma spécifique (par exemple, Person).
Jeux de données inclus
 include_dataset array

Retourne uniquement des entités de ces jeux de données.
Jeux de données exclus
 exclude_dataset array

Excluez les entités de ces jeux de données.
Schémas exclus
 exclude_schema array

Excluez les entités de ces types de schémas.
Modification depuis la date
 changed_since string

Incluez uniquement les entités mises à jour depuis cette date ISO.
Filtre de pays
 countries array

Filtrer par codes de pays (ISO 3166-1 alpha-2).
Filtre rubriques
 topics array

Limitez les résultats aux entités marquées avec des rubriques.
Filtre des jeux de données
 datasets array

Filtrez par identificateurs de jeu de données.
Filtre de champ
 filter array

Utilisez la syntaxe « field :value » pour filtrer les champs, par exemple, properties.birthDate :1985.
Limite des résultats
 limit integer

Nombre maximal de résultats à retourner (1 à 500).
Décalage de résultat
 offset integer

Décalage de démarrage pour les résultats paginés.
Ordre de tri
 sort array

Triez les résultats par champ, par exemple, score :desc.
Cible (déconseillée)
 target string

Deprecated. Utilisez plutôt le paramètre « topics ».
Recherche floue
 fuzzy boolean

Activez la correspondance approximative de texte flou (recherche approximative).
Mode simple
 simple boolean

Simplifiez les résultats en ignorant les métadonnées détaillées.
Champs de facette
 facets array

Retourne les nombres de facettes pour ces champs.
Opérateur de filtre
 filter_op string

Logique pour combiner plusieurs filtres (AND/OR).

Retours

SearchResponse
SearchResponse

Vérifier la préparation de l’index de recherche

ID d’opération :
Readyz_readyz_get

Retourne l’état de l’index de recherche pour indiquer si l’API est prête à gérer les requêtes. Utile pour surveiller la préparation au démarrage et au déploiement.

Retours

StatusResponse
StatusResponse

Vérifier l’état d’intégrité de l’API

ID d’opération :
Healthz_healthz_get

Retourne une réponse d’état simple confirmant que l’API est accessible et opérationnelle. Couramment utilisé par les outils de surveillance ou les sondes d’liveness Kubernetes.

Retours

StatusResponse
StatusResponse

Définitions

Algorithm

Nom Chemin d’accès Type Description
nom
 name string

Nom de l’algorithme de correspondance ou de scoring.
descriptif
 description string

Brève description de ce que fait l’algorithme.
features
 features object

Deprecated. Utilisez plutôt la propriété docs.
AlgorithmDocs
 docs AlgorithmDocs

Documentation pour un algorithme de scoring.

AlgorithmDocs

Documentation pour un algorithme de scoring.

Nom Chemin d’accès Type Description
nom
 name string
descriptif
 description
config
 config object
features
 features object

AlgorithmResponse

Nom Chemin d’accès Type Description
Algorithmes
 algorithms array of Algorithm
par défaut
 default string
meilleur
 best string

EntityMatchResponse

Nom Chemin d’accès Type Description
réponses
 responses object
Matcher
 matcher object

Informations sur le matcheur utilisé pour noter cette demande. Déconseillé, utilisez plutôt le /algorithms point de terminaison.
limit
 limit integer

EntityResponse

Nom Chemin d’accès Type Description
pièce d'identité
 id string
légende
 caption string
schéma
 schema string
Propriétés
 properties object
ensembles de données
 datasets array of string
Référents
 referents array of string
target
 target boolean
first_seen
 first_seen
last_seen
 last_seen
last_change
 last_change

FreebaseManifest

Nom Chemin d’accès Type Description
versions
 versions array of string
nom
 name string
identifierSpace
 identifierSpace string
schemaSpace
 schemaSpace string
documentation
 documentation string
taille de lot
 batchSize integer
FreebaseManifestView
 view FreebaseManifestView
FreebaseManifestPreview
 preview FreebaseManifestPreview
FreebaseManifestSuggest
 suggest FreebaseManifestSuggest
FreebaseManifestExtend
 extend FreebaseManifestExtend
defaultTypes
 defaultTypes array of FreebaseType

FreebaseManifestExtend

Nom Chemin d’accès Type Description
FreebaseManifestExtendProposeProperties
 propose_properties FreebaseManifestExtendProposeProperties
propose_settings
 propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

Nom Chemin d’accès Type Description
nom
 name string
label
 label string
type
 type string
par défaut
 default
help_text
 help_text string
choices
 choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

Nom Chemin d’accès Type Description
pièce d'identité
 id string
nom
 name string

FreebaseManifestExtendProposeProperties

Nom Chemin d’accès Type Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestPreview

Nom Chemin d’accès Type Description
URL
 url string
width
 width integer
height
 height integer

FreebaseManifestSuggest

Nom Chemin d’accès Type Description
FreebaseManifestSuggestType
 entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
 type FreebaseManifestSuggestType
FreebaseManifestSuggestType
 property FreebaseManifestSuggestType

FreebaseManifestSuggestType

Nom Chemin d’accès Type Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestView

Nom Chemin d’accès Type Description
URL
 url string

FreebaseType

Nom Chemin d’accès Type Description
pièce d'identité
 id string
nom
 name string
descriptif
 description

SearchResponse

Nom Chemin d’accès Type Description
limit
 limit integer
offset
 offset integer
TotalSpec
 total TotalSpec
results
 results array of EntityResponse
Facettes
 facets object

Statement

Nom Chemin d’accès Type Description
pièce d'identité
 id string
entity_id
 entity_id string
canonical_id
 canonical_id string
appui
 prop string
prop_type
 prop_type string
schéma
 schema string
value
 value string
original_value
 original_value
dataset
 dataset string
lang
 lang
first_seen
 first_seen date-time
last_seen
 last_seen date-time

StatementResponse

Nom Chemin d’accès Type Description
limit
 limit integer
offset
 offset integer
TotalSpec
 total TotalSpec
results
 results array of Statement

StatusResponse

Nom Chemin d’accès Type Description
status
 status string

TotalSpec

Nom Chemin d’accès Type Description
value
 value integer
relation
 relation string

objet

Il s’agit du type 'object'.