Megosztás:

OpenSanctions (független közzétevő) (előzetes verzió)

Az OpenSanctions API lehetővé teszi a globális szankciók és a politikailag közzétett személyek (PEP) adatbázisának keresését és lekérdezését. Végpontokat biztosít az entitásegyeztetéshez, a szöveges kereséshez, az entitások lekéréséhez és a részletes utasításszintű adatokhoz. Segítségével ellenőrizheti a felhasználókat vagy a vállalatokat a szankciólisták ellen, vagy felfedezheti az OpenSanctions entitásdiagramot.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service Class Régiók
Copilot Studio prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások Standard Az összes Logic Apps-régió , kivéve a következőket:
     - Azure Government-régiók
     - Azure China-régiók
     - Amerikai Védelmi Minisztérium (DoD)
Power Alkalmazások prémium Az összes Power Apps-régió , kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Power Automate prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Érintkezés
Név OpenSanctions
URL https://developments.substack.com
Email dan.romano@swolcat.com
Összekötő metaadatai
Kiadó krautrocker
Webhely https://www.opensanctions.org/
Adatvédelmi irányelvek https://www.opensanctions.org/docs/privacy/
Kategóriák Adat

OpenSanctions

Áttekintés

Az OpenSanctions API hozzáférést biztosít a politikai, büntetőjogi vagy gazdasági érdekű személyek és vállalatok globális adatbázisához. Több száz szankciólista, politikailag közzétett személy (PEP) és figyelőlisták adatait összesíti világszerte.

Ez az összekötő entitások egyeztetésére, keresésére és beolvasására, kapcsolatok feltárására és adathalmaz-lefedettség elemzésére használható.

További információ a OpenSanctions.org.

Kiadó - Dan Romano (swolcat)

Előfeltételek

Az összekötő használatához az OpenSanctions api-kulcsára lesz szüksége. Regisztráljon ingyenes kulcsra a következő címen: https://www.opensanctions.org/api/

Támogatott műveletek

Entitások egyeztetése adatkészlet szerint

Egyezik az entitásokkal a név és az opcionális mezők, például a születési dátum, az állampolgárság és az azonosítók alapján. Ez a végpont támogatja a homályos egyeztetést.

Entitások keresése egy adathalmazban

Entitások keresése egyszerű szöveges lekérdezéssel. Támogatja a szűrőket, témaköröket, országokat és adatkészleteket a pontosított keresésekhez.

Entitás lekérése azonosító alapján

Egyetlen entitásrekord lekérése egyedi azonosítója alapján, beleértve a beágyazott és a kapcsolódó attribútumokat is.

Szomszédos entitások lekérése

Adott entitással szomszédos entitásokat (például társvállalatokat, családtagokat vagy kapcsolódó vállalatokat) ad vissza.

Szomszédos entitások lekérése tulajdonság szerint

Kapcsolódó entitásokat ad vissza egy adott tulajdonsághoz (például familyPerson, ownershipOwner, membershipMember).

Adatkészlet-katalógus lekérése

Kérje le az OpenSanctionsen keresztül elérhető összes indexelt adathalmaz listáját.

Rendszerállapot lekérése

A szolgáltatás rendelkezésre állásának ellenőrzéséhez végezzen rendszerállapot-ellenőrzést.

Egyező algoritmusok lekérése

A rendszer által támogatott entitásegyeztetési algoritmusok listája.

Indexfrissítés kényszerítése

Aktiváljon újraindexelési műveletet, ha érvényes frissítési jogkivonattal rendelkezik.

Első lépések

  1. Hozzon létre egy fiókot a OpenSanctions.org.
  2. API-kulcs
  3. A Power Automate-ben vagy a Power Appsben hozzon létre egy új kapcsolatot az API-kulccsal.
  4. Az összekötő műveleteivel entitásokat kereshet, egyeztethet vagy lekérhet.

Hitelesítő adatok beszerzése

Látogasson el https://www.opensanctions.org/api/ egy API-kulcs igényléséhez. A fejlécben Authorization használni kívánt értéket kapApiKey:

Engedélyezés: ApiKey YOUR_API_KEY

Ismert problémák és korlátozások

  • A válaszstruktúrák dinamikusak; használja a "JSON elemzése" parancsot a Power Automate-ben a beágyazott értékek eléréséhez.
  • match A search végpontok az adathalmaz hatókörétől függően nagy válaszokat adhatnak vissza.
  • Egyes végpontok érvényes dataset paramétert igényelnek (pl. sanctions).
  • A nem támogatott mezők (például score) szerinti rendezés hibákat okozhat.
  • Az API-sebességkorlátok a csomagtól függően lehetnek érvényesek.

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:
Alapértelmezett A kapcsolat létrehozásának paraméterei. Minden régió Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név Típus Description Kötelező
API kulcs securestring Az api api_key True

Szabályozási korlátok

Name Hívások Megújítási időszak
API-hívások kapcsolatonként 100 60 másodperc

Műveletek

Adathalmaz entitásainak egyeztetése

A Google Refine (OpenRefine) API-val kompatibilis egyeztetési végpontot biztosít. Ezzel tömegesen egyeztetheti vagy ellenőrizheti az entitásneveket egy külső eszközből, például az OpenRefine-ből származó adatkészleten.
Adatkészlet-katalógus lekérése

Az OpenSanctions API összes elérhető és indexelt adathalmazát tartalmazó teljes szolgáltatáskatalógust adja vissza. Adathalmazok nevének és metaadatainak felderítéséhez hasznos.
Az API állapotának ellenőrzése

Egy egyszerű állapotválaszt ad vissza, amely megerősíti, hogy az API elérhető és működőképes. Gyakran használják a monitorozási eszközök vagy a Kubernetes liveness-mintavételei.
Entitás lekérése azonosító alapján

Az azonosító által megadott entitás teljes rekordját adja vissza, beleértve a kapcsolódó adatokat, például a tulajdonjogot, a társításokat és a csatolt tulajdonságokat.
Entitások egyeztetése adatkészletekkel

Ezzel a végponttal személyekkel vagy vállalatokkal egyeztethet egy adathalmazt homályos névvel, születési dátummal és állampolgársági feltételekkel. A kapott találatokat megbízhatósági küszöbértékekkel adja vissza.
Entitások keresése egy adathalmazban

Ezzel a végponttal kereshet entitásokat név vagy kulcsszó alapján egy adathalmazon belül. Támogatja a mezőszűrőket, a homályos egyezést és az opcionális arculati elemeket.
Entitásokkal szomszédos entitások lekérése

A megadott entitáshoz kapcsolódó entitásokat adja vissza, például kapcsolt személyeket, vállalatokat, azonosítókat vagy szankciókat. Az OpenSanctions-adathalmaz gráfkapcsolatainak feltárására használható.
Index újragenerálásának kényszerítése

Aktiválja a keresési index manuális újraépítését. Az engedélyezéshez érvényes frissítési jogkivonat szükséges. Ezzel frissítheti az adathalmazt adat- vagy struktúraváltozások esetén.
Kapcsolódó entitások lekérése tulajdonság szerint

Egy adott entitáshoz kapcsolódó entitásokat ad vissza egy adott tulajdonságon keresztül, például tulajdonjogot, családi kötelékeket vagy azonosítókat. Hasznos a gráfkapcsolatok részletes vizsgálatához.
Keresési index készültségének ellenőrzése

A keresési index állapotát adja vissza, amely jelzi, hogy az API készen áll-e a lekérdezések kezelésére. Hasznos az indítási és üzembe helyezési készültség monitorozásához.
Nyers entitáskivonatok lekérése

Részletes entitásadatokat ad vissza az OpenSanctions-adatbázis egyes utasításaiként. Minden utasítás egy forrásadatokból kinyert egyetlen tényt (például nevet, címet, születési dátumot) jelöl.
Támogatott egyező algoritmusok lekérése

Lekéri az API által az entitások összehasonlításához és az eredmények rangsorolásához használt összes támogatott egyeztetési és pontozási algoritmus listáját.

Adathalmaz entitásainak egyeztetése

Műveletazonosító:
Reconcile_reconcile__dataset__get

A Google Refine (OpenRefine) API-val kompatibilis egyeztetési végpontot biztosít. Ezzel tömegesen egyeztetheti vagy ellenőrizheti az entitásneveket egy külső eszközből, például az OpenRefine-ből származó adatkészleten.

Paraméterek

Name Kulcs Kötelező Típus Description
Céladatkészlet
 dataset True string

Az adatkészlet vagy a gyűjtemény neve, a összehasonlítása.

Válaszok

FreebaseManifest
FreebaseManifest

Adatkészlet-katalógus lekérése

Műveletazonosító:
Catalog_catalog_get

Az OpenSanctions API összes elérhető és indexelt adathalmazát tartalmazó teljes szolgáltatáskatalógust adja vissza. Adathalmazok nevének és metaadatainak felderítéséhez hasznos.

Válaszok

response
object

Az API állapotának ellenőrzése

Műveletazonosító:
Healthz_healthz_get

Egy egyszerű állapotválaszt ad vissza, amely megerősíti, hogy az API elérhető és működőképes. Gyakran használják a monitorozási eszközök vagy a Kubernetes liveness-mintavételei.

Válaszok

StatusResponse
StatusResponse

Entitás lekérése azonosító alapján

Műveletazonosító:
Fetch_entity_entities__entity_id__get

Az azonosító által megadott entitás teljes rekordját adja vissza, beleértve a kapcsolódó adatokat, például a tulajdonjogot, a társításokat és a csatolt tulajdonságokat.

Paraméterek

Name Kulcs Kötelező Típus Description
Entitásazonosító
 entity_id True string

A lekérendő entitás egyedi azonosítója.
Beágyazott entitások belefoglalása
 nested boolean

Csatolt vagy kapcsolódó entitások belefoglalása a válaszba.

Válaszok

Dinamikus JSON-objektum. Minden mezőtípust engedélyez ellenőrzés nélkül.

response
object

Entitások egyeztetése adatkészletekkel

Műveletazonosító:
Match_match__dataset__post

Ezzel a végponttal személyekkel vagy vállalatokkal egyeztethet egy adathalmazt homályos névvel, születési dátummal és állampolgársági feltételekkel. A kapott találatokat megbízhatósági küszöbértékekkel adja vissza.

Paraméterek

Name Kulcs Kötelező Típus Description
Céladatkészlet neve
 dataset True string

Adatkészlet vagy gyűjtemény neve az egyező lekérdezés futtatásához.
Eredménykorlát
 limit integer

A visszaadandó egyezések maximális száma (1–500).
Egybeesési küszöbérték
 threshold double

Az eredmény minimális pontszáma (0–1).
Kivágási pontszám
 cutoff double

Minimális elfogadható pontszám a legjobb meccsek leépítéséhez.
Algoritmus verziója
 algorithm string

Egyező algoritmus, például logic-v1.
Belefoglalt adathalmazok
 include_dataset array

Az egyezésbe kifejezetten belefoglalandó adathalmazok.
Kizárt sémák
 exclude_schema array

Az egyeztetési folyamatból kizárandó sémák.
Kizárt adathalmazok
 exclude_dataset array

Az egyeztetési folyamatból kizárandó adathalmazok.
Témakörök szűrője
 topics array

Az ezekkel a témakörökkel címkézett entitásokra vonatkozó egyezések korlátozása.
Módosítás dátuma óta
 changed_since string

Csak az ISO-dátum óta módosított entitásokat tartalmazza.
Kizárt entitásazonosítók
 exclude_entity_ids array

Az egyezés során figyelmen kívül hagyandó entitásazonosítók. Hamis pozitív vagy korábban ellenőrzött entitások szűrésére használható.
Tartalomtípus fejléce
 Content-Type string

A kérelem törzsének tartalomtípusa (alkalmazás/json).
Súlyok
 weights object
config
 config object

Algoritmusspecifikus konfigurációs paraméterek.
queries
 queries True object

Válaszok

EntityMatchResponse
EntityMatchResponse

Entitások keresése egy adathalmazban

Műveletazonosító:
Search_search__dataset__get

Ezzel a végponttal kereshet entitásokat név vagy kulcsszó alapján egy adathalmazon belül. Támogatja a mezőszűrőket, a homályos egyezést és az opcionális arculati elemeket.

Paraméterek

Name Kulcs Kötelező Típus Description
Céladatkészlet
 dataset True string

A kereséshez használható adatkészlet vagy gyűjtemény.
Keresési lekérdezés
 q string

Keresendő szöveg, például név vagy kulcsszó.
Sémaszűrő
 schema string

Az eredmények korlátozása egy adott sémára (például személyre).
Belefoglalt adathalmazok
 include_dataset array

Csak ezekből az adathalmazokból ad vissza entitásokat.
Kizárt adathalmazok
 exclude_dataset array

Entitások kizárása ezekből az adathalmazokból.
Kizárt sémák
 exclude_schema array

Zárja ki az ilyen sématípusok entitásait.
Módosítás dátuma óta
 changed_since string

Csak az ISO-dátum óta frissített entitásokat tartalmazza.
Országszűrő
 countries array

Szűrés országkódok szerint (ISO 3166-1 alpha-2).
Témakörök szűrője
 topics array

Az eredmények korlátozása témakörökkel címkézett entitásokra.
Adathalmazok szűrője
 datasets array

Szűrés adathalmaz-azonosítók alapján.
Mezőszűrő
 filter array

A "mező:érték" szintaxis használatával szűrheti a mezőket, például: properties.birthDate:1985.
Eredménykorlát
 limit integer

A visszaadandó eredmények maximális száma (1–500).
Eredmény eltolása
 offset integer

Oldalszámozott eredmények kezdő eltolása.
Rendezési sorrend
 sort array

Eredmények rendezése mező szerint, például score:desc.
Cél (elavult)
 target string

Deprecated. Használja inkább a "topics" paramétert.
Homályos keresés
 fuzzy boolean

Homályos szöveg egyeztetésének engedélyezése (hozzávetőleges keresés).
Egyszerű mód
 simple boolean

A részletes metaadatok kihagyásával egyszerűsítheti az eredményeket.
Aspektusmezők
 facets array

A mezők aspektusainak számát adja vissza.
Szűrő operátor
 filter_op string

Több szűrő (AND/OR) kombinálására használható logika.

Válaszok

SearchResponse
SearchResponse

Entitásokkal szomszédos entitások lekérése

Műveletazonosító:
Fetch_Adjacent_Entities__entities__entity_id__adjacent_get

A megadott entitáshoz kapcsolódó entitásokat adja vissza, például kapcsolt személyeket, vállalatokat, azonosítókat vagy szankciókat. Az OpenSanctions-adathalmaz gráfkapcsolatainak feltárására használható.

Paraméterek

Name Kulcs Kötelező Típus Description
Entitásazonosító
 entity_id True string

Annak az entitásnak az egyedi azonosítója, amelynek kapcsolatait le szeretné kérni.
Rendezési sorrend
 sort array

Eredmények rendezése mező szerint, például score:desc.
Eredménykorlát
 limit integer

A visszaadandó kapcsolódó entitások maximális száma (1–500).
Eredmény eltolása
 offset integer

Lapszámozott kapcsolódó entitások eltolásának kezdete.

Válaszok

response
object

Index újragenerálásának kényszerítése

Műveletazonosító:
Force_update_updatez_post

Aktiválja a keresési index manuális újraépítését. Az engedélyezéshez érvényes frissítési jogkivonat szükséges. Ezzel frissítheti az adathalmazt adat- vagy struktúraváltozások esetén.

Paraméterek

Name Kulcs Kötelező Típus Description
Jogkivonat frissítése
 token string

Az index újraépítésének engedélyezéséhez szükséges API-jogkivonat.
Szinkronizálási mód
 sync boolean

Futtassa szinkronban, és várja meg az index befejezését.

Válaszok

StatusResponse
StatusResponse

Kapcsolódó entitások lekérése tulajdonság szerint

Műveletazonosító:
Fetch_Adjacent_by_Property__entities__entity_id__adjacent__property_name__get

Egy adott entitáshoz kapcsolódó entitásokat ad vissza egy adott tulajdonságon keresztül, például tulajdonjogot, családi kötelékeket vagy azonosítókat. Hasznos a gráfkapcsolatok részletes vizsgálatához.

Paraméterek

Name Kulcs Kötelező Típus Description
Entitásazonosító
 entity_id True string

Annak az entitásnak az egyedi azonosítója, amelynek kapcsolódó elemeit le szeretné kérni.
Tulajdonság megnevezése
 property_name True string

A kapcsolódó entitások beolvasásához használt tulajdonságnév.
Rendezési sorrend
 sort array

Kapcsolódó entitások rendezése mező szerint, például score:desc.
Eredménykorlát
 limit integer

A visszaadandó kapcsolódó entitások maximális száma (1–500).
Eredmény eltolása
 offset integer

A lapszámozott kapcsolódó eredmények eltolásának kezdete.

Válaszok

A kapcsolódó entitásokat ismétlődő dinamikus JSON-struktúra. Minden tulajdonság tartalmazhat sztringtömböket vagy beágyazott entitásobjektumokat.

response
object

Keresési index készültségének ellenőrzése

Műveletazonosító:
Readyz_readyz_get

A keresési index állapotát adja vissza, amely jelzi, hogy az API készen áll-e a lekérdezések kezelésére. Hasznos az indítási és üzembe helyezési készültség monitorozásához.

Válaszok

StatusResponse
StatusResponse

Nyers entitáskivonatok lekérése

Műveletazonosító:
Statements_statements_get

Részletes entitásadatokat ad vissza az OpenSanctions-adatbázis egyes utasításaiként. Minden utasítás egy forrásadatokból kinyert egyetlen tényt (például nevet, címet, születési dátumot) jelöl.

Paraméterek

Name Kulcs Kötelező Típus Description
Adatkészlet neve
 dataset string

Az eredmények korlátozása az adatkészletből származó utasításokra.
Entitásazonosító
 entity_id string

Az entitásazonosítóhoz társított utasításokat adja vissza.
Canonical ID
 canonical_id string

A canonical entity ID utasításainak lekérése.
Tulajdonságszűrő
 prop string

Utasítások szűrése tulajdonságnév alapján.
Tulajdonságérték
 value string

A tulajdonságértéket tartalmazó szűrési utasítások.
Sémaszűrő
 schema string

Utasítások korlátozása adott séma entitásaira.
Rendezési sorrend
 sort array

Eredmények rendezése mező szerint, például időbélyeg:desc.
Eredménykorlát
 limit integer

A visszaadandó utasítások maximális száma (1–5000).
Eredmény eltolása
 offset integer

Lapszámozott eredmények kezdő eltolása.

Válaszok

StatementResponse
StatementResponse

Támogatott egyező algoritmusok lekérése

Műveletazonosító:
Algorithms_algorithms_get

Lekéri az API által az entitások összehasonlításához és az eredmények rangsorolásához használt összes támogatott egyeztetési és pontozási algoritmus listáját.

Válaszok

AlgorithmResponse
AlgorithmResponse

Definíciók

Algorithm

Name Elérési út Típus Description
név
 name string

Az egyező vagy pontozó algoritmus neve.
leírás
 description string

Az algoritmus rövid leírása.
features
 features object

Deprecated. Használja inkább a docs tulajdonságot.
AlgorithmDocs
 docs AlgorithmDocs

Pontozó algoritmus dokumentációja.

AlgorithmDocs

Pontozó algoritmus dokumentációja.

Name Elérési út Típus Description
név
 name string
leírás
 description
config
 config object
features
 features object

AlgorithmResponse

Name Elérési út Típus Description
Algoritmusok
 algorithms array of Algorithm
alapértelmezett
 default string
legjobb
 best string

EntityMatchResponse

Name Elérési út Típus Description
Válaszok
 responses object
Matcher
 matcher object

A kérés pontozásához használt egyező adatai. Elavult, használja inkább a végpontot /algorithms .
limit
 limit integer

EntityResponse

Name Elérési út Típus Description
azonosító
 id string
felirat
 caption string
séma
 schema string
tulajdonságok
 properties object
adatkészletek
 datasets array of string
referensek
 referents array of string
céladatbázis
 target boolean
first_seen
 first_seen
last_seen
 last_seen
last_change
 last_change

FreebaseManifest

Name Elérési út Típus Description
versions
 versions array of string
név
 name string
identifierSpace
 identifierSpace string
schemaSpace
 schemaSpace string
dokumentáció
 documentation string
csomagméret
 batchSize integer
FreebaseManifestView
 view FreebaseManifestView
FreebaseManifestPreview
 preview FreebaseManifestPreview
FreebaseManifestSuggest
 suggest FreebaseManifestSuggest
FreebaseManifestExtend
 extend FreebaseManifestExtend
defaultTypes
 defaultTypes array of FreebaseType

FreebaseManifestExtend

Name Elérési út Típus Description
FreebaseManifestExtendProposeProperties
 propose_properties FreebaseManifestExtendProposeProperties
propose_settings
 propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

Name Elérési út Típus Description
név
 name string
címke
 label string
típus
 type string
alapértelmezett
 default
help_text
 help_text string
choices
 choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

Name Elérési út Típus Description
azonosító
 id string
név
 name string

FreebaseManifestExtendProposeProperties

Name Elérési út Típus Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestPreview

Name Elérési út Típus Description
URL-cím
 url string
szélesség
 width integer
magasság
 height integer

FreebaseManifestSuggest

Name Elérési út Típus Description
FreebaseManifestSuggestType
 entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
 type FreebaseManifestSuggestType
FreebaseManifestSuggestType
 property FreebaseManifestSuggestType

FreebaseManifestSuggestType

Name Elérési út Típus Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestView

Name Elérési út Típus Description
URL-cím
 url string

FreebaseType

Name Elérési út Típus Description
azonosító
 id string
név
 name string
leírás
 description

SearchResponse

Name Elérési út Típus Description
limit
 limit integer
eltolás
 offset integer
TotalSpec
 total TotalSpec
results
 results array of EntityResponse
Arcát
 facets object

Statement

Name Elérési út Típus Description
azonosító
 id string
entity_id
 entity_id string
canonical_id
 canonical_id string
támaszt
 prop string
prop_type
 prop_type string
séma
 schema string
value
 value string
original_value
 original_value
adathalmaz
 dataset string
Lang
 lang
first_seen
 first_seen date-time
last_seen
 last_seen date-time

StatementResponse

Name Elérési út Típus Description
limit
 limit integer
eltolás
 offset integer
TotalSpec
 total TotalSpec
results
 results array of Statement

StatusResponse

Name Elérési út Típus Description
állapot
 status string

TotalSpec

Name Elérési út Típus Description
value
 value integer
reláció
 relation string

objektum

Ez az "objektum" típus.