Sdílet prostřednictvím

OpenSanctions (nezávislý vydavatel) (Preview)

Rozhraní OPENSanctions API umožňuje vyhledávat a dotazovat globální sankce a databáze osob, které jsou vystaveny z politického hlediska. Poskytuje koncové body pro porovnávání entit, vyhledávání textu, načítání entit a podrobná data na úrovni příkazů. Můžete ho použít ke kontrole lidí nebo společností proti seznamům sankcí nebo prozkoumání grafu entit OpenSanctions.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure Government
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název OpenSanctions
URL https://developments.substack.com
Email dan.romano@swolcat.com
Metadata konektoru
Vydavatel krautrocker
Internetová stránka https://www.opensanctions.org/
Zásady ochrany osobních údajů https://www.opensanctions.org/docs/privacy/
Kategorie Data

OpenSanctions

Přehled

Rozhraní OpenSanctions API poskytuje přístup k globální databázi osob a společností politických, trestních nebo ekonomických zájmů. Agreguje data ze stovek seznamů sankcí, politicky vystavených osob (PEP) a kontrolních seznamů po celém světě.

Tento konektor můžete použít ke shodě, vyhledávání a načítání entit, zkoumání relací a analýze pokrytí datové sady.

Další informace najdete v OpenSanctions.org.

Vydavatel - Dan Romano (swolcat)

Požadavky

K použití tohoto konektoru budete potřebovat klíč rozhraní API z OpenSanctions. Zaregistrujte si bezplatný klíč na adrese: https://www.opensanctions.org/api/

Podporované operace

Shoda entit podle datové sady

Porovná entity na základě názvu a volitelných polí, jako jsou datum narození, státní příslušnost a identifikátory. Tento koncový bod podporuje přibližné shody.

Vyhledávání entit v datové sadě

Prohledávejte entity pomocí jednoduchého textového dotazu. Podporuje filtry, témata, země a datové sady pro upřesňující hledání.

Získání entity podle ID

Načtení jednoho záznamu entity podle jeho jedinečného identifikátoru, včetně vnořených a souvisejících atributů

Získání sousedních entit

Vrácení entit sousedících se zadanou entitou (např. přidružení, členové rodiny nebo související společnosti).

Získání sousedních entit podle vlastnosti

Vrátí související entity pro konkrétní vlastnost (např. familyPerson, ownershipOwner, membershipMember).

Získání katalogu datových sad

Načtěte seznam všech indexovaných datových sad dostupných prostřednictvím OpenSanctions.

Získání stavu systému

Zkontrolujte stav systému a ověřte dostupnost služby.

Získání odpovídajících algoritmů

Seznam podporovaných algoritmů porovnávání entit používaných systémem

Vynucení aktualizace indexu

Pokud má autorizaci platný aktualizační token, aktivujte operaci opětovného indexování.

Začínáme

  1. Vytvořte účet na OpenSanctions.org.
  2. Klíč rozhraní API
  3. V Power Automate nebo Power Apps vytvořte nové připojení pomocí klíče rozhraní API.
  4. Pomocí akcí konektoru můžete vyhledávat, shodovat nebo načítat entity.

Získání přihlašovacích údajů

Navštivte https://www.opensanctions.org/api/ žádost o klíč rozhraní API. Dostanete ApiKey hodnotu, která by se měla použít v Authorization záhlaví:

Autorizace: YOUR_API_KEY ApiKey

Známé problémy a omezení

  • Struktury odpovědí jsou dynamické; Pro přístup k vnořeným hodnotám použijte v Power Automate parsovat JSON.
  • match Koncové search body můžou v závislosti na rozsahu datové sady vracet velké odpovědi.
  • Některé koncové body vyžadují platný dataset parametr (např sanctions. ).
  • Řazení podle nepodporovaných polí (například score) může aktivovat chyby.
  • Limity rychlosti rozhraní API se můžou v závislosti na vašem plánu uplatňovat.

Vytvoření připojení

Konektor podporuje následující typy ověřování:
výchozí Parametry pro vytvoření připojení Všechny oblasti Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název Typ Description Povinné
klíč API securestring Api_key pro toto rozhraní API Pravdivé

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Kontrola připravenosti indexu vyhledávání

Vrátí stav indexu vyhledávání, který označuje, jestli je rozhraní API připravené ke zpracování dotazů. Užitečné pro monitorování připravenosti při spuštění a nasazení.
Kontrola stavu rozhraní API

Vrátí jednoduchou odpověď na stav, která potvrzuje, že rozhraní API je dostupné a funkční. Běžně používané monitorovacími nástroji nebo sondami aktivity Kubernetes.
Odsouhlasení entit pro datovou sadu

Poskytuje koncový bod odsouhlasení kompatibilní s rozhraním API Google Refine (OpenRefine). Tuto možnost použijte k hromadné shodě nebo ověření názvů entit u datové sady z externího nástroje, jako je OpenRefine.
Porovnávání entit s datovou sadou

Tento koncový bod použijte ke spárování lidí nebo společností s datovou sadou pomocí přibližného názvu, data narození a kritérií státní příslušnosti. Vrátí vyhodnocené výsledky shody s prahovými hodnotami spolehlivosti.
Vyhledávání entit v datové sadě

Tento koncový bod použijte k vyhledávání entit podle názvu nebo klíčového slova v datové sadě. Podporuje filtry polí, přibližné shody a volitelné fasetování.
Vynucení regenerace indexu

Aktivuje ruční opětovné sestavení indexu vyhledávání. Vyžaduje platný aktualizační token pro autorizaci. Tuto možnost použijte k aktualizaci datové sady, když dojde ke změnám dat nebo struktury.
Získání entit sousedících s entitou

Vrátí entity propojené se zadanou entitou, jako jsou propojené osoby, společnosti, identifikátory nebo sankce. Užitečné pro zkoumání vztahů grafů v datové sadě OpenSanctions.
Získání entity podle ID

Vrátí úplný záznam pro entitu určenou jejím ID, včetně souvisejících dat, jako jsou vlastnictví, přidružení a propojené vlastnosti.
Získání katalogu datových sad

Vrátí úplný katalog služeb obsahující všechny dostupné a indexované datové sady v rozhraní OpenSanctions API. Užitečné pro zjišťování názvů a metadat datových sad.
Získání nezpracovaných příkazů entity

Vrátí podrobná data entity jako jednotlivé příkazy z databáze OpenSanctions. Každý příkaz představuje jeden fakt (např. jméno, adresu, datum narození) extrahovaný ze zdrojových dat.
Získání podporovaných odpovídajících algoritmů

Načte seznam všech podporovaných shodných a bodovacích algoritmů používaných rozhraním API pro porovnání entit a řazení výsledků.
Získání souvisejících entit podle vlastnosti

Vrátí entity související s danou entitou prostřednictvím konkrétní vlastnosti, jako je vlastnictví, vazby rodiny nebo identifikátory. Užitečné pro podrobné zkoumání vztahů grafů.

Kontrola připravenosti indexu vyhledávání

ID operace:
Readyz_readyz_get

Vrátí stav indexu vyhledávání, který označuje, jestli je rozhraní API připravené ke zpracování dotazů. Užitečné pro monitorování připravenosti při spuštění a nasazení.

Návraty

StatusResponse
StatusResponse

Kontrola stavu rozhraní API

ID operace:
Healthz_healthz_get

Vrátí jednoduchou odpověď na stav, která potvrzuje, že rozhraní API je dostupné a funkční. Běžně používané monitorovacími nástroji nebo sondami aktivity Kubernetes.

Návraty

StatusResponse
StatusResponse

Odsouhlasení entit pro datovou sadu

ID operace:
Reconcile_reconcile__dataset__get

Poskytuje koncový bod odsouhlasení kompatibilní s rozhraním API Google Refine (OpenRefine). Tuto možnost použijte k hromadné shodě nebo ověření názvů entit u datové sady z externího nástroje, jako je OpenRefine.

Parametry

Name Klíč Vyžadováno Typ Description
Cílová datová sada
 dataset True string

Název datové sady nebo kolekce pro odsouhlasení.

Návraty

FreebaseManifest
FreebaseManifest

Porovnávání entit s datovou sadou

ID operace:
Match_match__dataset__post

Tento koncový bod použijte ke spárování lidí nebo společností s datovou sadou pomocí přibližného názvu, data narození a kritérií státní příslušnosti. Vrátí vyhodnocené výsledky shody s prahovými hodnotami spolehlivosti.

Parametry

Name Klíč Vyžadováno Typ Description
Název cílové datové sady
 dataset True string

Název datové sady nebo kolekce pro spuštění odpovídajícího dotazu
Limit výsledků
 limit integer

Maximální počet shod, které se mají vrátit (1–500).
Prahová hodnota shody
 threshold double

Minimální skóre, které má obsahovat výsledek (0–1).
Skóre pro odříznutí
 cutoff double

Minimální přijatelné skóre pro nejlepší výsledek zápasu.
Verze algoritmu
 algorithm string

Odpovídající algoritmus, který se má použít, např. logika-v1.
Zahrnuté datové sady
 include_dataset array

Datové sady, které se explicitně zahrnou do shody.
Vyloučená schémata
 exclude_schema array

Schémata, která se mají vyloučit z procesu shody
Vyloučené datové sady
 exclude_dataset array

Datové sady, které se mají vyloučit z procesu shody.
Filtr témat
 topics array

Omezit shody na entity označené těmito tématy.
Změna od data
 changed_since string

Zahrnout pouze entity změněné od tohoto data ISO.
Id vyloučených entit
 exclude_entity_ids array

ID entit, která se mají během párování ignorovat. Slouží k filtrování falešně pozitivních nebo dříve kontrolovaných entit.
Hlavička typu obsahu
 Content-Type string

Typ obsahu textu požadavku (application/json).
hmotnosti
 weights object
config
 config object

Parametry konfigurace specifické pro algoritmus
queries
 queries True object

Návraty

EntityMatchResponse
EntityMatchResponse

Vyhledávání entit v datové sadě

ID operace:
Search_search__dataset__get

Tento koncový bod použijte k vyhledávání entit podle názvu nebo klíčového slova v datové sadě. Podporuje filtry polí, přibližné shody a volitelné fasetování.

Parametry

Name Klíč Vyžadováno Typ Description
Cílová datová sada
 dataset True string

Datová sada nebo kolekce, které se mají prohledávat.
Vyhledávání
 q string

Text, který chcete vyhledat, například název nebo klíčové slovo.
Filtr schématu
 schema string

Omezit výsledky na konkrétní schéma (např. Osoba).
Zahrnuté datové sady
 include_dataset array

Vrátí pouze entity z těchto datových sad.
Vyloučené datové sady
 exclude_dataset array

Vylučte entity z těchto datových sad.
Vyloučená schémata
 exclude_schema array

Vylučte entity těchto typů schématu.
Změna od data
 changed_since string

Zahrnout pouze entity aktualizované od tohoto data ISO.
Filtr země
 countries array

Filtrujte podle kódů zemí (ISO 3166-1 alfa-2).
Filtr témat
 topics array

Omezit výsledky na entity označené tématy.
Filtr datových sad
 datasets array

Filtrovat podle identifikátorů datových sad
Filtr polí
 filter array

Pomocí syntaxe field:value můžete filtrovat pole, například properties.birthDate:1985.
Limit výsledků
 limit integer

Maximální počet výsledků, které se mají vrátit (1–500).
Posun výsledku
 offset integer

Počáteční posun stránkovaných výsledků
Řazení
 sort array

Seřaďte výsledky podle pole, například score:desc.
Cíl (zastaralý)
 target string

Deprecated. Místo toho použijte parametr topics.
Fuzzy vyhledávání
 fuzzy boolean

Povolte přibližné porovnávání textu (přibližné hledání).
Jednoduchý režim
 simple boolean

Zjednodušte výsledky přeskočením podrobných metadat.
Pole omezující vlastnosti
 facets array

Vrátí počet omezujících vlastností pro tato pole.
Operátor filtru
 filter_op string

Logika pro kombinování více filtrů (AND/OR)

Návraty

SearchResponse
SearchResponse

Vynucení regenerace indexu

ID operace:
Force_update_updatez_post

Aktivuje ruční opětovné sestavení indexu vyhledávání. Vyžaduje platný aktualizační token pro autorizaci. Tuto možnost použijte k aktualizaci datové sady, když dojde ke změnám dat nebo struktury.

Parametry

Name Klíč Vyžadováno Typ Description
Aktualizace tokenu
 token string

Token rozhraní API potřebný k autorizaci opětovného sestavení indexu.
Režim synchronizace
 sync boolean

Spusťte synchronně a počkejte na dokončení indexu.

Návraty

StatusResponse
StatusResponse

Získání entit sousedících s entitou

ID operace:
Fetch_Adjacent_Entities__entities__entity_id__adjacent_get

Vrátí entity propojené se zadanou entitou, jako jsou propojené osoby, společnosti, identifikátory nebo sankce. Užitečné pro zkoumání vztahů grafů v datové sadě OpenSanctions.

Parametry

Name Klíč Vyžadováno Typ Description
Identifikátor entity
 entity_id True string

Jedinečné ID entity, jejíž připojení se mají načíst.
Řazení
 sort array

Seřaďte výsledky podle pole, například score:desc.
Limit výsledků
 limit integer

Maximální počet souvisejících entit, které se mají vrátit (1–500).
Posun výsledku
 offset integer

Počáteční posun pro stránkované související entity

Návraty

response
object

Získání entity podle ID

ID operace:
Fetch_entity_entities__entity_id__get

Vrátí úplný záznam pro entitu určenou jejím ID, včetně souvisejících dat, jako jsou vlastnictví, přidružení a propojené vlastnosti.

Parametry

Name Klíč Vyžadováno Typ Description
Identifikátor entity
 entity_id True string

Jedinečné ID entity, která se má načíst.
Zahrnutí vnořených entit
 nested boolean

Do odpovědi zahrňte propojené nebo související entity.

Návraty

Dynamický objekt JSON Umožňuje všechny typy polí bez ověření.

response
object

Získání katalogu datových sad

ID operace:
Catalog_catalog_get

Vrátí úplný katalog služeb obsahující všechny dostupné a indexované datové sady v rozhraní OpenSanctions API. Užitečné pro zjišťování názvů a metadat datových sad.

Návraty

response
object

Získání nezpracovaných příkazů entity

ID operace:
Statements_statements_get

Vrátí podrobná data entity jako jednotlivé příkazy z databáze OpenSanctions. Každý příkaz představuje jeden fakt (např. jméno, adresu, datum narození) extrahovaný ze zdrojových dat.

Parametry

Name Klíč Vyžadováno Typ Description
Název datové sady
 dataset string

Omezte výsledky na příkazy z této datové sady.
Identifikátor entity
 entity_id string

Návratové příkazy propojené s tímto ID entity
Kanonické ID
 canonical_id string

Příkazy Fetch pro kanonické ID entity.
Filtr vlastností
 prop string

Příkazy filtru podle názvu vlastnosti
Hodnota vlastnosti
 value string

Příkazy filtru obsahující tuto hodnotu vlastnosti.
Filtr schématu
 schema string

Omezte příkazy na entity daného schématu.
Řazení
 sort array

Seřaďte výsledky podle pole, například timestamp:desc.
Limit výsledků
 limit integer

Maximální počet příkazů, které se mají vrátit (1–5000).
Posun výsledku
 offset integer

Počáteční posun stránkovaných výsledků

Návraty

PříkazResponse
StatementResponse

Získání podporovaných odpovídajících algoritmů

ID operace:
Algorithms_algorithms_get

Načte seznam všech podporovaných shodných a bodovacích algoritmů používaných rozhraním API pro porovnání entit a řazení výsledků.

Návraty

AlgorithmResponse
AlgorithmResponse

Získání souvisejících entit podle vlastnosti

ID operace:
Fetch_Adjacent_by_Property__entities__entity_id__adjacent__property_name__get

Vrátí entity související s danou entitou prostřednictvím konkrétní vlastnosti, jako je vlastnictví, vazby rodiny nebo identifikátory. Užitečné pro podrobné zkoumání vztahů grafů.

Parametry

Name Klíč Vyžadováno Typ Description
Identifikátor entity
 entity_id True string

Jedinečné ID entity, jejíž související položky se mají načíst.
Název vlastnosti
 property_name True string

Název vlastnosti použitý k načtení souvisejících entit.
Řazení
 sort array

Seřaďte související entity podle pole, například score:desc.
Limit výsledků
 limit integer

Maximální počet souvisejících entit, které se mají vrátit (1–500).
Posun výsledku
 offset integer

Počáteční posun pro stránkované související výsledky

Návraty

Dynamická struktura JSON reprsenting related entities. Každá vlastnost může obsahovat pole řetězců nebo vnořených objektů entity.

response
object

Definice

Algorithm

Name Cesta Typ Description
název
 name string

Název odpovídajícího nebo bodovacího algoritmu.
popis
 description string

Stručný popis toho, co algoritmus dělá.
features
 features object

Deprecated. docs Místo toho použijte vlastnost.
AlgorithmDocs
 docs AlgorithmDocs

Dokumentace k hodnoticímu algoritmu

AlgorithmDocs

Dokumentace k hodnoticímu algoritmu

Name Cesta Typ Description
název
 name string
popis
 description
config
 config object
features
 features object

AlgorithmResponse

Name Cesta Typ Description
algoritmy
 algorithms array of Algorithm
výchozí
 default string
nejlepší
 best string

EntityMatchResponse

Name Cesta Typ Description
odpovědi
 responses object
dohazovač
 matcher object

Informace o nástroji shody, který byl použit k určení skóre tohoto požadavku. Zastaralé, místo toho použijte /algorithms koncový bod.
limit
 limit integer

EntityResponse

Name Cesta Typ Description
identifikační číslo
 id string
popis
 caption string
schéma
 schema string
vlastnosti
 properties object
datové sady
 datasets array of string
referents
 referents array of string
cíl
 target boolean
first_seen
 first_seen
last_seen
 last_seen
last_change
 last_change

FreebaseManifest

Name Cesta Typ Description
versions
 versions array of string
název
 name string
IdentifierSpace
 identifierSpace string
schemaSpace
 schemaSpace string
dokumentace
 documentation string
velikost_dávky
 batchSize integer
FreebaseManifestView
 view FreebaseManifestView
FreebaseManifestPreview
 preview FreebaseManifestPreview
FreebaseManifestSuggest
 suggest FreebaseManifestSuggest
FreebaseManifestExtend
 extend FreebaseManifestExtend
defaultTypes
 defaultTypes array of FreebaseType

FreebaseManifestExtend

Name Cesta Typ Description
FreebaseManifestExtendProposeProperties
 propose_properties FreebaseManifestExtendProposeProperties
propose_settings
 propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

Name Cesta Typ Description
název
 name string
jmenovka
 label string
typ
 type string
výchozí
 default
help_text
 help_text string
choices
 choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

Name Cesta Typ Description
identifikační číslo
 id string
název
 name string

FreebaseManifestExtendProposeProperties

Name Cesta Typ Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestPreview

Name Cesta Typ Description
adresa URL
 url string
šířka
 width integer
výška
 height integer

FreebaseManifestSuggest

Name Cesta Typ Description
FreebaseManifestSuggestType
 entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
 type FreebaseManifestSuggestType
FreebaseManifestSuggestType
 property FreebaseManifestSuggestType

FreebaseManifestSuggestType

Name Cesta Typ Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestView

Name Cesta Typ Description
adresa URL
 url string

FreebaseType

Name Cesta Typ Description
identifikační číslo
 id string
název
 name string
popis
 description

SearchResponse

Name Cesta Typ Description
limit
 limit integer
posun
 offset integer
TotalSpec
 total TotalSpec
results
 results array of EntityResponse
fasety
 facets object

Statement

Name Cesta Typ Description
identifikační číslo
 id string
entity_id
 entity_id string
canonical_id
 canonical_id string
podpěra
 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

PříkazResponse

Name Cesta Typ Description
limit
 limit integer
posun
 offset integer
TotalSpec
 total TotalSpec
results
 results array of Statement

StatusResponse

Name Cesta Typ Description
stav
 status string

TotalSpec

Name Cesta Typ Description
value
 value integer
relace
 relation string

objekt

Toto je typ "object".