Delen via

OpenSanctions (Onafhankelijke uitgever) (preview)

Met de OpenSanctions-API kunt u zoeken en query's uitvoeren op de globale sancties en de database met politiek blootgestelde personen (PEP). Het biedt eindpunten voor entiteitskoppeling, tekstzoekopdrachten, het ophalen van entiteiten en gedetailleerde gegevens op instructieniveau. Gebruik deze om personen of bedrijven te controleren op lijsten met sancties of om de entiteitsgrafiek OpenSanctions te verkennen.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic Apps- Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government-regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam OpenSanctions
URL https://developments.substack.com
E-mailen dan.romano@swolcat.com
Connector-metagegevens
Uitgever krautrocker
Webpagina https://www.opensanctions.org/
Privacybeleid https://www.opensanctions.org/docs/privacy/
Categorieën Gegevens

OpenSanctions

Overzicht

De OpenSanctions-API biedt toegang tot een globale database van personen en bedrijven van politiek, crimineel of economisch belang. Het verzamelt gegevens uit honderden sanctieslijsten, politiek blootgestelde personen (PEP's) en watchlists over de hele wereld.

U kunt deze connector gebruiken om entiteiten te vinden, te zoeken en op te halen, relaties te verkennen en de dekking van gegevenssets te analyseren.

Meer informatie vindt u op OpenSanctions.org.

Uitgever - Dan Geconverteerd (swolcat)

Vereiste voorwaarden

U hebt een API-sleutel van OpenSanctions nodig om deze connector te kunnen gebruiken. Registreer u voor een gratis sleutel op: https://www.opensanctions.org/api/

Ondersteunde bewerkingen

Entiteiten vergelijken per gegevensset

Entiteiten vergelijken op basis van naam en optionele velden, zoals geboortedatum, nationaliteit en id's. Dit eindpunt biedt ondersteuning voor fuzzy overeenkomsten.

Entiteiten zoeken in een gegevensset

Entiteiten zoeken met behulp van een eenvoudige tekstquery. Ondersteunt filters, onderwerpen, landen en gegevenssets voor verfijnde zoekopdrachten.

Entiteit ophalen op id

Haal één entiteitsrecord op met de unieke id, inclusief geneste en gerelateerde kenmerken.

Aangrenzende entiteiten ophalen

Entiteiten retourneren die grenzen aan een opgegeven entiteit (bijvoorbeeld associates, familieleden of gerelateerde bedrijven).

Aangrenzende entiteiten ophalen op eigenschap

Gerelateerde entiteiten retourneren voor een specifieke eigenschap (bijvoorbeeld familyPerson, ownershipOwner, membershipMember).

Gegevenssetcatalogus ophalen

Haal de lijst met alle geïndexeerde gegevenssets op die beschikbaar zijn via OpenSanctions.

Systeemstatus ophalen

Voer een systeemstatuscontrole uit om de beschikbaarheid van de service te controleren.

Overeenkomende algoritmen ophalen

Lijst met ondersteunde algoritmen voor entiteitskoppeling die door het systeem worden gebruikt.

Indexupdate afdwingen

Activeer een herindexeringsbewerking als deze is geautoriseerd met een geldig updatetoken.

Aan de slag komen

  1. Maak een account op OpenSanctions.org.
  2. Een API-sleutel
  3. Maak in Power Automate of Power Apps een nieuwe verbinding met behulp van uw API-sleutel.
  4. Gebruik de acties van de connector om entiteiten te zoeken, te vergelijken of op te halen.

Referenties verkrijgen

Bezoek https://www.opensanctions.org/api/ om een API-sleutel aan te vragen. U ontvangt een ApiKey waarde die moet worden gebruikt in de Authorization header:

Autorisatie: ApiKey-YOUR_API_KEY

Bekende problemen en beperkingen

  • Antwoordstructuren zijn dynamisch; gebruik JSON parseren in Power Automate voor toegang tot geneste waarden.
  • De search en match eindpunten kunnen grote antwoorden retourneren, afhankelijk van het bereik van de gegevensset.
  • Voor sommige eindpunten is een geldige dataset parameter vereist (bijvoorbeeld sanctions).
  • Het sorteren op niet-ondersteunde velden (zoals score) kan fouten veroorzaken.
  • API-frequentielimieten kunnen van toepassing zijn, afhankelijk van uw abonnement.

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:
standaard Parameters voor het maken van verbinding. Alle regio's Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam Typologie Description Verplicht
API-sleutel beveiligde string De api_key voor deze API Klopt

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Entiteit ophalen op id

Retourneert de volledige record voor een entiteit die is opgegeven met de id, inclusief gerelateerde gegevens, zoals eigendom, koppelingen en gekoppelde eigenschappen.
Entiteiten afstemmen voor een gegevensset

Biedt een afstemmingseindpunt dat compatibel is met de Google Refine-API (OpenRefine). Gebruik dit om entiteitsnamen bulksgewijs te vergelijken of te verifiëren voor een gegevensset vanuit een extern hulpprogramma, zoals OpenRefine.
Entiteiten ophalen die grenzen aan een entiteit

Retourneert entiteiten die zijn verbonden met de opgegeven entiteit, zoals gekoppelde personen, bedrijven, id's of sancties. Handig voor het verkennen van grafiekrelaties in de Gegevensset OpenSanctions.
Entiteiten vergelijken met een gegevensset

Gebruik dit eindpunt om personen of bedrijven te vergelijken met een gegevensset met behulp van fuzzy naam, geboortedatum en nationaliteitscriteria. Retourneert gescoorde wedstrijdresultaten met betrouwbaarheidsdrempels.
Entiteiten zoeken in een gegevensset

Gebruik dit eindpunt om entiteiten te doorzoeken op naam of trefwoord in een gegevensset. Ondersteunt veldfilters, fuzzy matching en optioneel facet.
Gegevenssetcatalogus ophalen

Retourneert de volledige servicecatalogus met alle beschikbare en geïndexeerde gegevenssets in de OpenSanctions-API. Handig voor het detecteren van namen en metagegevens van gegevenssets.
Gereedheid van zoekindex controleren

Retourneert de status van de zoekindex om aan te geven of de API gereed is voor het afhandelen van query's. Handig voor het bewaken van de opstart- en implementatiegereedheid.
Gerelateerde entiteiten ophalen op eigenschap

Retourneert entiteiten die zijn gerelateerd aan een bepaalde entiteit via een specifieke eigenschap, zoals eigendom, familierelaties of id's. Handig voor het verkennen van grafiekrelaties in detail.
Indexregeneratie afdwingen

Hiermee wordt een handmatige herbouw van de zoekindex geactiveerd. Vereist een geldig updatetoken voor autorisatie. Gebruik deze optie om de gegevensset te vernieuwen wanneer gegevens of structuurwijzigingen optreden.
Onbewerkte entiteitsinstructies ophalen

Retourneert gedetailleerde entiteitsgegevens als afzonderlijke instructies uit de OpenSanctions-database. Elke instructie vertegenwoordigt één feit (bijvoorbeeld naam, adres, geboortedatum) geëxtraheerd uit brongegevens.
Ondersteunde overeenkomende algoritmen ophalen

Haalt een lijst op met alle ondersteunde overeenkomende en scorealgoritmen die door de API worden gebruikt voor entiteitsvergelijking en resultatenclassificatie.
Status van API controleren

Retourneert een eenvoudig statusantwoord dat bevestigt dat de API bereikbaar en operationeel is. Wordt vaak gebruikt door bewakingshulpprogramma's of Kubernetes-livenesstests.

Entiteit ophalen op id

Bewerkings-id:
Fetch_entity_entities__entity_id__get

Retourneert de volledige record voor een entiteit die is opgegeven met de id, inclusief gerelateerde gegevens, zoals eigendom, koppelingen en gekoppelde eigenschappen.

Parameters

Name Sleutel Vereist Type Description
Entiteits-id
 entity_id True string

Unieke id van de entiteit die moet worden opgehaald.
Geneste entiteiten opnemen
 nested boolean

Voeg gekoppelde of gerelateerde entiteiten in het antwoord toe.

Retouren

Dynamisch JSON-object. Hiermee staat u alle veldtypen zonder validatie toe.

response
object

Entiteiten afstemmen voor een gegevensset

Bewerkings-id:
Reconcile_reconcile__dataset__get

Biedt een afstemmingseindpunt dat compatibel is met de Google Refine-API (OpenRefine). Gebruik dit om entiteitsnamen bulksgewijs te vergelijken of te verifiëren voor een gegevensset vanuit een extern hulpprogramma, zoals OpenRefine.

Parameters

Name Sleutel Vereist Type Description
Doelgegevensset
 dataset True string

Naam van gegevensset of verzameling die u wilt afstemmen.

Retouren

FreebaseManifest
FreebaseManifest

Entiteiten ophalen die grenzen aan een entiteit

Bewerkings-id:
Fetch_Adjacent_Entities__entities__entity_id__adjacent_get

Retourneert entiteiten die zijn verbonden met de opgegeven entiteit, zoals gekoppelde personen, bedrijven, id's of sancties. Handig voor het verkennen van grafiekrelaties in de Gegevensset OpenSanctions.

Parameters

Name Sleutel Vereist Type Description
Entiteits-id
 entity_id True string

Unieke id van de entiteit waarvan de verbindingen moeten worden opgehaald.
Sorteervolgorde
 sort array

Resultaten sorteren op veld, bijvoorbeeld score:desc.
Resultaatlimiet
 limit integer

Maximum aantal gerelateerde entiteiten dat moet worden geretourneerd (1-500).
Resultaatverschil
 offset integer

Verschuiving starten voor gepagineerde gerelateerde entiteiten.

Retouren

response
object

Entiteiten vergelijken met een gegevensset

Bewerkings-id:
Match_match__dataset__post

Gebruik dit eindpunt om personen of bedrijven te vergelijken met een gegevensset met behulp van fuzzy naam, geboortedatum en nationaliteitscriteria. Retourneert gescoorde wedstrijdresultaten met betrouwbaarheidsdrempels.

Parameters

Name Sleutel Vereist Type Description
Naam van doelgegevensset
 dataset True string

De naam van de gegevensset of verzameling waarop de overeenkomstquery moet worden uitgevoerd.
Resultaatlimiet
 limit integer

Maximum aantal overeenkomsten dat moet worden geretourneerd (1-500).
Drempelwaarde voor overeenkomst
 threshold double

Minimumscore om een resultaat op te nemen (0-1).
Cutoff-score
 cutoff double

Minimum acceptabele score voor beste match cutoff.
Algoritmeversie
 algorithm string

Overeenkomend algoritme dat moet worden gebruikt, bijvoorbeeld logic-v1.
Opgenomen gegevenssets
 include_dataset array

Gegevenssets die expliciet moeten worden opgenomen in de overeenkomst.
Uitgesloten schema's
 exclude_schema array

Schema's die moeten worden uitgesloten van het overeenkomstproces.
Uitgesloten gegevenssets
 exclude_dataset array

Gegevenssets die moeten worden uitgesloten van het overeenkomstproces.
Onderwerpenfilter
 topics array

Beperk overeenkomsten tot entiteiten die zijn gelabeld met deze onderwerpen.
Gewijzigd sinds datum
 changed_since string

Voeg alleen entiteiten toe die zijn gewijzigd sinds deze ISO-datum.
Uitgesloten entiteits-id's
 exclude_entity_ids array

Entiteits-id's die moeten worden genegeerd tijdens het vergelijken. Gebruik dit om fout-positieven of eerder gecontroleerde entiteiten te filteren.
Koptekst van inhoudstype
 Content-Type string

Inhoudstype van de aanvraagbody (toepassing/json).
Gewichten
 weights object
config
 config object

Algoritmespecifieke configuratieparameters.
queries
 queries True object

Retouren

EntityMatchResponse
EntityMatchResponse

Entiteiten zoeken in een gegevensset

Bewerkings-id:
Search_search__dataset__get

Gebruik dit eindpunt om entiteiten te doorzoeken op naam of trefwoord in een gegevensset. Ondersteunt veldfilters, fuzzy matching en optioneel facet.

Parameters

Name Sleutel Vereist Type Description
Doelgegevensset
 dataset True string

Gegevensset of verzameling om binnen te zoeken.
Zoekquery
 q string

Te zoeken tekst, zoals een naam of trefwoord.
Schemafilter
 schema string

Beperk de resultaten tot een specifiek schema (bijvoorbeeld Persoon).
Opgenomen gegevenssets
 include_dataset array

Alleen entiteiten van deze gegevenssets retourneren.
Uitgesloten gegevenssets
 exclude_dataset array

Entiteiten uitsluiten van deze gegevenssets.
Uitgesloten schema's
 exclude_schema array

Entiteiten van deze schematypen uitsluiten.
Gewijzigd sinds datum
 changed_since string

Neem alleen entiteiten op die zijn bijgewerkt sinds deze ISO-datum.
Landfilter
 countries array

Filteren op landcodes (ISO 3166-1 alfa-2).
Onderwerpenfilter
 topics array

Beperk resultaten tot entiteiten die zijn getagd met onderwerpen.
Filter voor gegevenssets
 datasets array

Filter op gegevensset-id's.
Veldfilter
 filter array

Gebruik de syntaxis 'field:value' om velden te filteren, bijvoorbeeld properties.birthDate:1985.
Resultaatlimiet
 limit integer

Maximum aantal resultaten dat moet worden geretourneerd (1-500).
Resultaatverschil
 offset integer

Verschuiving starten voor gepaginade resultaten.
Sorteervolgorde
 sort array

Resultaten sorteren op veld, bijvoorbeeld score:desc.
Doel (afgeschaft)
 target string

Afgeschreven Gebruik in plaats daarvan de parameter 'onderwerpen'.
Fuzzy zoekopdracht
 fuzzy boolean

Fuzzy tekstvergelijking inschakelen (bij benadering zoeken).
Eenvoudige modus
 simple boolean

Vereenvoudig de resultaten door gedetailleerde metagegevens over te slaan.
Facetvelden
 facets array

Retourneer facetten voor deze velden.
Filteroperator
 filter_op string

Logica voor het combineren van meerdere filters (AND/OR).

Retouren

SearchResponse
SearchResponse

Gegevenssetcatalogus ophalen

Bewerkings-id:
Catalog_catalog_get

Retourneert de volledige servicecatalogus met alle beschikbare en geïndexeerde gegevenssets in de OpenSanctions-API. Handig voor het detecteren van namen en metagegevens van gegevenssets.

Retouren

response
object

Gereedheid van zoekindex controleren

Bewerkings-id:
Readyz_readyz_get

Retourneert de status van de zoekindex om aan te geven of de API gereed is voor het afhandelen van query's. Handig voor het bewaken van de opstart- en implementatiegereedheid.

Retouren

StatusResponse
StatusResponse

Gerelateerde entiteiten ophalen op eigenschap

Bewerkings-id:
Fetch_Adjacent_by_Property__entities__entity_id__adjacent__property_name__get

Retourneert entiteiten die zijn gerelateerd aan een bepaalde entiteit via een specifieke eigenschap, zoals eigendom, familierelaties of id's. Handig voor het verkennen van grafiekrelaties in detail.

Parameters

Name Sleutel Vereist Type Description
Entiteits-id
 entity_id True string

Unieke id van de entiteit waarvan de gerelateerde items moeten worden opgehaald.
Naam van de eigenschap
 property_name True string

Eigenschapsnaam die wordt gebruikt om gerelateerde entiteiten op te halen.
Sorteervolgorde
 sort array

Gerelateerde entiteiten sorteren op veld, bijvoorbeeld score:desc.
Resultaatlimiet
 limit integer

Maximum aantal gerelateerde entiteiten dat moet worden geretourneerd (1-500).
Resultaatverschil
 offset integer

Verschuiving starten voor gepagineerde gerelateerde resultaten.

Retouren

Dynamische JSON-structuur die gerelateerde entiteiten reprsent. Elke eigenschap kan matrices van tekenreeksen of geneste entiteitsobjecten bevatten.

response
object

Indexregeneratie afdwingen

Bewerkings-id:
Force_update_updatez_post

Hiermee wordt een handmatige herbouw van de zoekindex geactiveerd. Vereist een geldig updatetoken voor autorisatie. Gebruik deze optie om de gegevensset te vernieuwen wanneer gegevens of structuurwijzigingen optreden.

Parameters

Name Sleutel Vereist Type Description
Token bijwerken
 token string

API-token dat is vereist om het opnieuw samenstellen van de index te autoriseren.
Synchronisatiemodus
 sync boolean

Voer synchroon uit en wacht totdat de index is voltooid.

Retouren

StatusResponse
StatusResponse

Onbewerkte entiteitsinstructies ophalen

Bewerkings-id:
Statements_statements_get

Retourneert gedetailleerde entiteitsgegevens als afzonderlijke instructies uit de OpenSanctions-database. Elke instructie vertegenwoordigt één feit (bijvoorbeeld naam, adres, geboortedatum) geëxtraheerd uit brongegevens.

Parameters

Name Sleutel Vereist Type Description
Naam van de gegevensset
 dataset string

Beperk resultaten tot instructies uit deze gegevensset.
Entiteits-id
 entity_id string

Retourinstructies die zijn gekoppeld aan deze entiteits-id.
Canonieke id
 canonical_id string

Haal instructies op voor de canonieke entiteits-id.
Eigenschapsfilter
 prop string

Filterinstructies op eigenschapsnaam.
Eigenschapswaarde
 value string

Filterinstructies met deze eigenschapswaarde.
Schemafilter
 schema string

Beperk instructies tot entiteiten van een bepaald schema.
Sorteervolgorde
 sort array

Resultaten sorteren op veld, bijvoorbeeld tijdstempel:desc.
Resultaatlimiet
 limit integer

Maximum aantal instructies dat moet worden geretourneerd (1-5000).
Resultaatverschil
 offset integer

Verschuiving starten voor gepagineerde resultaten.

Retouren

StatementResponse
StatementResponse

Ondersteunde overeenkomende algoritmen ophalen

Bewerkings-id:
Algorithms_algorithms_get

Haalt een lijst op met alle ondersteunde overeenkomende en scorealgoritmen die door de API worden gebruikt voor entiteitsvergelijking en resultatenclassificatie.

Retouren

AlgorithmResponse
AlgorithmResponse

Status van API controleren

Bewerkings-id:
Healthz_healthz_get

Retourneert een eenvoudig statusantwoord dat bevestigt dat de API bereikbaar en operationeel is. Wordt vaak gebruikt door bewakingshulpprogramma's of Kubernetes-livenesstests.

Retouren

StatusResponse
StatusResponse

Definities

Algorithm

Name Pad Type Description
naam
 name string

Naam van het overeenkomende of score-algoritme.
beschrijving
 description string

Korte beschrijving van wat het algoritme doet.
features
 features object

Afgeschreven Gebruik in plaats daarvan de docs eigenschap.
AlgorithmDocs
 docs AlgorithmDocs

Documentatie voor een score-algoritme.

AlgorithmDocs

Documentatie voor een score-algoritme.

Name Pad Type Description
naam
 name string
beschrijving
 description
config
 config object
features
 features object

AlgorithmResponse

Name Pad Type Description
Algoritmen
 algorithms array of Algorithm
standaard
 default string
best
 best string

EntityMatchResponse

Name Pad Type Description
Reacties
 responses object
Matcher
 matcher object

Informatie over de matcher die is gebruikt om deze aanvraag te scoren. Afgeschaft, gebruik /algorithms in plaats daarvan eindpunt.
limit
 limit integer

EntityResponse

Name Pad Type Description
identiteitskaart
 id string
bijschrift
 caption string
schema
 schema string
properties
 properties object
gegevenssets
 datasets array of string
referents
 referents array of string
target
 target boolean
first_seen
 first_seen
last_seen
 last_seen
last_change
 last_change

FreebaseManifest

Name Pad Type Description
versions
 versions array of string
naam
 name string
identifierSpace
 identifierSpace string
schemaSpace
 schemaSpace string
documentatie
 documentation string
batchgrootte
 batchSize integer
FreebaseManifestView
 view FreebaseManifestView
FreebaseManifestPreview
 preview FreebaseManifestPreview
FreebaseManifestSuggest
 suggest FreebaseManifestSuggest
FreebaseManifestExtend
 extend FreebaseManifestExtend
defaultTypes
 defaultTypes array of FreebaseType

FreebaseManifestExtend

Name Pad Type Description
FreebaseManifestExtendProposeProperties
 propose_properties FreebaseManifestExtendProposeProperties
propose_settings
 propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

Name Pad Type Description
naam
 name string
label
 label string
type
 type string
standaard
 default
help_text
 help_text string
choices
 choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

Name Pad Type Description
identiteitskaart
 id string
naam
 name string

FreebaseManifestExtendProposeProperties

Name Pad Type Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestPreview

Name Pad Type Description
url
 url string
width
 width integer
height
 height integer

FreebaseManifestSuggest

Name Pad Type Description
FreebaseManifestSuggestType
 entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
 type FreebaseManifestSuggestType
FreebaseManifestSuggestType
 property FreebaseManifestSuggestType

FreebaseManifestSuggestType

Name Pad Type Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestView

Name Pad Type Description
url
 url string

FreebaseType

Name Pad Type Description
identiteitskaart
 id string
naam
 name string
beschrijving
 description

SearchResponse

Name Pad Type Description
limit
 limit integer
offset
 offset integer
TotalSpec
 total TotalSpec
results
 results array of EntityResponse
Facetten
 facets object

Statement

Name Pad Type Description
identiteitskaart
 id string
entity_id
 entity_id string
canonical_id
 canonical_id string
steun
 prop string
prop_type
 prop_type string
schema
 schema string
waarde
 value string
original_value
 original_value
dataset
 dataset string
lang
 lang
first_seen
 first_seen date-time
last_seen
 last_seen date-time

StatementResponse

Name Pad Type Description
limit
 limit integer
offset
 offset integer
TotalSpec
 total TotalSpec
results
 results array of Statement

StatusResponse

Name Pad Type Description
status
 status string

TotalSpec

Name Pad Type Description
waarde
 value integer
relatie
 relation string

Voorwerp

Dit is het type object.