Udostępnij przez


OpenSanctions (niezależny wydawca) (wersja zapoznawcza)

Interfejs API OpenSanctions umożliwia wyszukiwanie i wykonywanie zapytań dotyczących globalnych sankcji oraz baz danych osób uwidocznionych politycznie (PEP). Udostępnia punkty końcowe do dopasowywania jednostek, wyszukiwania tekstu, pobierania jednostek i szczegółowych danych na poziomie instrukcji. Służy do sprawdzania osób lub firm przed listami sankcji lub eksplorowania grafu jednostek OpenSanctions.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate - narzędzie do automatyzacji procesów Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name OpenSanctions
adres URL https://developments.substack.com
Email dan.romano@swolcat.com
Metadane łącznika
Publisher krautrocker
Witryna internetowa https://www.opensanctions.org/
Zasady ochrony prywatności https://www.opensanctions.org/docs/privacy/
Kategorie Dane

OpenSanctions

Przegląd

Interfejs API OpenSanctions zapewnia dostęp do globalnej bazy danych osób i firm interesów politycznych, przestępczych lub gospodarczych. Agreguje dane z setek list sankcji, osób uwidocznionych politycznie i list obserwowanych na całym świecie.

Ten łącznik umożliwia dopasowywanie, wyszukiwanie i pobieranie jednostek, eksplorowanie relacji i analizowanie pokrycia zestawu danych.

Dowiedz się więcej na stronie OpenSanctions.org.

Wydawca — Dan Romano (swolcat)

Wymagania wstępne

Aby użyć tego łącznika, potrzebny będzie klucz interfejsu API z biblioteki OpenSanctions. Zarejestruj się w celu uzyskania bezpłatnego klucza w: https://www.opensanctions.org/api/

Obsługiwane operacje

Dopasowywanie jednostek według zestawu danych

Dopasuj jednostki na podstawie nazw i opcjonalnych pól, takich jak data urodzenia, narodowość i identyfikatory. Ten punkt końcowy obsługuje dopasowywanie rozmyte.

Wyszukiwanie jednostek w zestawie danych

Wyszukiwanie jednostek przy użyciu prostego zapytania tekstowego. Obsługuje filtry, tematy, kraje i zestawy danych w celu wyszukiwania uściślionych.

Pobieranie jednostki według identyfikatora

Pobieranie pojedynczego rekordu jednostki według unikatowego identyfikatora, w tym zagnieżdżonych i powiązanych atrybutów.

Uzyskiwanie sąsiednich jednostek

Zwraca jednostki sąsiadujące z określoną jednostką (np. skojarzeń, członków rodziny lub powiązanych firm).

Pobieranie sąsiednich jednostek według właściwości

Zwracanie powiązanych jednostek dla określonej właściwości (np. familyPerson, ownershipOwner, membershipMember).

Pobieranie wykazu zestawów danych

Pobierz listę wszystkich indeksowanych zestawów danych dostępnych za pośrednictwem usługi OpenSanctions.

Uzyskiwanie kondycji systemu

Wykonaj kontrolę kondycji systemu, aby zweryfikować dostępność usługi.

Uzyskiwanie pasujących algorytmów

Lista obsługiwanych algorytmów dopasowywania jednostek używanych przez system.

Wymuszanie aktualizacji indeksu

Wyzwól operację ponownego indeksowania, jeśli została autoryzowana przy użyciu prawidłowego tokenu aktualizacji.

Wprowadzenie

  1. Utwórz konto w OpenSanctions.org.
  2. Klucz interfejsu API
  3. W usłudze Power Automate lub Power Apps utwórz nowe połączenie przy użyciu klucza interfejsu API.
  4. Użyj akcji łącznika, aby wyszukiwać, dopasowywać lub pobierać jednostki.

Uzyskiwanie poświadczeń

Odwiedź stronę https://www.opensanctions.org/api/ , aby zażądać klucza interfejsu API. Otrzymasz ApiKey wartość, która powinna być używana w nagłówku Authorization :

Autoryzacja: YOUR_API_KEY ApiKey

Znane problemy i ograniczenia

  • Struktury odpowiedzi są dynamiczne; Użyj ciągu "Przeanalizuj dane JSON" w usłudze Power Automate, aby uzyskać dostęp do wartości zagnieżdżonych.
  • Punkty search końcowe i match mogą zwracać duże odpowiedzi w zależności od zakresu zestawu danych.
  • Niektóre punkty końcowe wymagają prawidłowego dataset parametru (np. sanctions).
  • Sortowanie według nieobsługiwanych pól (na przykład score) może powodować błędy.
  • Limity szybkości interfejsu API mogą mieć zastosowanie w zależności od planu.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
klucz_api securestring Api_key dla tego interfejsu API Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Dopasowywanie jednostek do zestawu danych

Użyj tego punktu końcowego, aby dopasować osoby lub firmy do zestawu danych przy użyciu nazwy rozmytej, daty urodzenia i kryteriów narodowości. Zwraca wyniki oceny dopasowania z progami ufności.

Pobieranie jednostek przylegających do jednostki

Zwraca jednostki połączone z określoną jednostką, takie jak połączone osoby, firmy, identyfikatory lub sankcje. Przydatne do eksplorowania relacji grafów w zestawie danych OpenSanctions.

Pobieranie jednostki według identyfikatora

Zwraca pełny rekord jednostki określonej przez jej identyfikator, w tym powiązane dane, takie jak własność, skojarzenia i połączone właściwości.

Pobieranie nieprzetworzonych instrukcji jednostki

Zwraca szczegółowe dane jednostki jako poszczególne instrukcje z bazy danych OpenSanctions. Każda instrukcja reprezentuje pojedynczy fakt (np. nazwę, adres, datę urodzenia) wyodrębniony z danych źródłowych.

Pobieranie powiązanych jednostek według właściwości

Zwraca jednostki powiązane z daną jednostką za pośrednictwem określonej właściwości, takiej jak własność, więzi rodzinne lub identyfikatory. Przydatne do szczegółowego eksplorowania relacji grafu.

Pobieranie wykazu zestawów danych

Zwraca pełny wykaz usług zawierający wszystkie dostępne i indeksowane zestawy danych w interfejsie API OpenSanctions. Przydatne do odnajdywania nazw i metadanych zestawów danych.

Sprawdzanie gotowości indeksu wyszukiwania

Zwraca stan indeksu wyszukiwania, aby wskazać, czy interfejs API jest gotowy do obsługi zapytań. Przydatne do monitorowania gotowości do uruchamiania i wdrażania.

Sprawdzanie stanu kondycji interfejsu API

Zwraca prostą odpowiedź stanu potwierdzając, że interfejs API jest osiągalny i operacyjny. Często używane przez narzędzia do monitorowania lub sondy na żywo platformy Kubernetes.

Uzgadnianie jednostek dla zestawu danych

Udostępnia punkt końcowy uzgodnień zgodny z interfejsem API Google Refine (OpenRefine). Służy do zbiorczego dopasowywania lub weryfikowania nazw jednostek względem zestawu danych z zewnętrznego narzędzia, takiego jak OpenRefine.

Uzyskiwanie obsługiwanych algorytmów dopasowania

Pobiera listę wszystkich obsługiwanych algorytmów dopasowywania i oceniania używanych przez interfejs API do porównywania jednostek i klasyfikacji wyników.

Wymuś rewitalizowanie indeksu

Wyzwala ręczną ponowną kompilację indeksu wyszukiwania. Wymaga prawidłowego tokenu aktualizacji do autoryzacji. Użyj tego polecenia, aby odświeżyć zestaw danych, gdy wystąpią zmiany danych lub struktury.

Wyszukiwanie jednostek w zestawie danych

Ten punkt końcowy służy do wyszukiwania jednostek według nazwy lub słowa kluczowego w zestawie danych. Obsługuje filtry pól, dopasowywanie rozmyte i opcjonalne aspekty.

Dopasowywanie jednostek do zestawu danych

Użyj tego punktu końcowego, aby dopasować osoby lub firmy do zestawu danych przy użyciu nazwy rozmytej, daty urodzenia i kryteriów narodowości. Zwraca wyniki oceny dopasowania z progami ufności.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa docelowego zestawu danych
dataset True string

Nazwa zestawu danych lub kolekcji do uruchomienia kwerendy dopasowania.

Limit wyników
limit integer

Maksymalna liczba dopasowań do zwrócenia (1–500).

Próg dopasowania
threshold double

Minimalny wynik w celu uwzględnienia wyniku (0–1).

Wynik odcięcia
cutoff double

Minimalny akceptowalny wynik dla najlepszego odcięcia dopasowania.

Wersja algorytmu
algorithm string

Dopasowywanie algorytmu do użycia, np. logic-v1.

Dołączone zestawy danych
include_dataset array

Zestawy danych do jawnego uwzględnienia w dopasowaniu.

Wykluczone schematy
exclude_schema array

Schematy do wykluczenia z procesu dopasowania.

Wykluczone zestawy danych
exclude_dataset array

Zestawy danych do wykluczenia z procesu dopasowania.

Filtr tematów
topics array

Ogranicz dopasowania do jednostek oznaczonych tymi tematami.

Zmieniono od daty
changed_since string

Uwzględnij tylko jednostki zmienione od tej daty ISO.

Wykluczone identyfikatory jednostek
exclude_entity_ids array

Identyfikatory jednostek do ignorowania podczas dopasowywania. Służy do filtrowania wyników fałszywie dodatnich lub poprzednio przeglądanych jednostek.

Nagłówek typu zawartości
Content-Type string

Typ zawartości treści żądania (application/json).

Wagi
weights object
konfig
config object

Parametry konfiguracji specyficzne dla algorytmu.

queries
queries True object

Zwraca

EntityMatchResponse
EntityMatchResponse

Pobieranie jednostek przylegających do jednostki

Zwraca jednostki połączone z określoną jednostką, takie jak połączone osoby, firmy, identyfikatory lub sankcje. Przydatne do eksplorowania relacji grafów w zestawie danych OpenSanctions.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator encji
entity_id True string

Unikatowy identyfikator jednostki, której połączenia mają być pobierane.

Kolejność sortowania
sort array

Sortuj wyniki według pola, np. score:desc.

Limit wyników
limit integer

Maksymalna liczba powiązanych jednostek do zwrócenia (1–500).

Przesunięcie wyniku
offset integer

Uruchamianie przesunięcia dla jednostek powiązanych z podziałem na strony.

Zwraca

response
object

Pobieranie jednostki według identyfikatora

Zwraca pełny rekord jednostki określonej przez jej identyfikator, w tym powiązane dane, takie jak własność, skojarzenia i połączone właściwości.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator encji
entity_id True string

Unikatowy identyfikator jednostki do pobrania.

Uwzględnij zagnieżdżone jednostki
nested boolean

Dołącz połączone lub powiązane jednostki w odpowiedzi.

Zwraca

Dynamiczny obiekt JSON. Zezwala na wszystkie typy pól bez walidacji.

response
object

Pobieranie nieprzetworzonych instrukcji jednostki

Zwraca szczegółowe dane jednostki jako poszczególne instrukcje z bazy danych OpenSanctions. Każda instrukcja reprezentuje pojedynczy fakt (np. nazwę, adres, datę urodzenia) wyodrębniony z danych źródłowych.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa zestawu danych
dataset string

Ogranicz wyniki do instrukcji z tego zestawu danych.

Identyfikator encji
entity_id string

Instrukcje zwracane połączone z tym identyfikatorem jednostki.

Identyfikator kanoniczny
canonical_id string

Pobierz instrukcje dla identyfikatora jednostki kanonicznej.

Filtr właściwości
prop string

Filtruj instrukcje według nazwy właściwości.

Wartość właściwości
value string

Instrukcje filtru zawierające tę wartość właściwości.

Filtr schematu
schema string

Ogranicz instrukcje do jednostek danego schematu.

Kolejność sortowania
sort array

Sortuj wyniki według pola, np. znacznik czasu:desc.

Limit wyników
limit integer

Maksymalna liczba instrukcji do zwrócenia (1–5000).

Przesunięcie wyniku
offset integer

Uruchamianie przesunięcia dla wyników podzielonych na strony.

Zwraca

StatementResponse
StatementResponse

Pobieranie powiązanych jednostek według właściwości

Zwraca jednostki powiązane z daną jednostką za pośrednictwem określonej właściwości, takiej jak własność, więzi rodzinne lub identyfikatory. Przydatne do szczegółowego eksplorowania relacji grafu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator encji
entity_id True string

Unikatowy identyfikator jednostki, której powiązane elementy mają być pobierane.

Nazwa właściwości
property_name True string

Nazwa właściwości używana do pobierania powiązanych jednostek.

Kolejność sortowania
sort array

Sortuj powiązane jednostki według pola, np. score:desc.

Limit wyników
limit integer

Maksymalna liczba powiązanych jednostek do zwrócenia (1–500).

Przesunięcie wyniku
offset integer

Uruchamianie przesunięcia dla wyników powiązanych z podziałem na strony.

Zwraca

Dynamiczna struktura JSON pokutuje powiązanymi jednostkami. Każda właściwość może zawierać tablice ciągów lub zagnieżdżonych obiektów jednostek.

response
object

Pobieranie wykazu zestawów danych

Zwraca pełny wykaz usług zawierający wszystkie dostępne i indeksowane zestawy danych w interfejsie API OpenSanctions. Przydatne do odnajdywania nazw i metadanych zestawów danych.

Zwraca

response
object

Sprawdzanie gotowości indeksu wyszukiwania

Zwraca stan indeksu wyszukiwania, aby wskazać, czy interfejs API jest gotowy do obsługi zapytań. Przydatne do monitorowania gotowości do uruchamiania i wdrażania.

Zwraca

StatusResponse
StatusResponse

Sprawdzanie stanu kondycji interfejsu API

Zwraca prostą odpowiedź stanu potwierdzając, że interfejs API jest osiągalny i operacyjny. Często używane przez narzędzia do monitorowania lub sondy na żywo platformy Kubernetes.

Zwraca

StatusResponse
StatusResponse

Uzgadnianie jednostek dla zestawu danych

Udostępnia punkt końcowy uzgodnień zgodny z interfejsem API Google Refine (OpenRefine). Służy do zbiorczego dopasowywania lub weryfikowania nazw jednostek względem zestawu danych z zewnętrznego narzędzia, takiego jak OpenRefine.

Parametry

Nazwa Klucz Wymagane Typ Opis
Docelowy zestaw danych
dataset True string

Nazwa zestawu danych lub kolekcji do uzgodnienia.

Zwraca

FreebaseManifest
FreebaseManifest

Uzyskiwanie obsługiwanych algorytmów dopasowania

Pobiera listę wszystkich obsługiwanych algorytmów dopasowywania i oceniania używanych przez interfejs API do porównywania jednostek i klasyfikacji wyników.

Zwraca

AlgorithmResponse
AlgorithmResponse

Wymuś rewitalizowanie indeksu

Wyzwala ręczną ponowną kompilację indeksu wyszukiwania. Wymaga prawidłowego tokenu aktualizacji do autoryzacji. Użyj tego polecenia, aby odświeżyć zestaw danych, gdy wystąpią zmiany danych lub struktury.

Parametry

Nazwa Klucz Wymagane Typ Opis
Aktualizowanie tokenu
token string

Token interfejsu API wymagany do autoryzowania ponownego kompilowania indeksu.

Tryb synchronizacji
sync boolean

Uruchom synchronicznie i poczekaj na ukończenie indeksu.

Zwraca

StatusResponse
StatusResponse

Wyszukiwanie jednostek w zestawie danych

Ten punkt końcowy służy do wyszukiwania jednostek według nazwy lub słowa kluczowego w zestawie danych. Obsługuje filtry pól, dopasowywanie rozmyte i opcjonalne aspekty.

Parametry

Nazwa Klucz Wymagane Typ Opis
Docelowy zestaw danych
dataset True string

Zestaw danych lub kolekcja do wyszukania.

Zapytanie wyszukiwania
q string

Tekst do wyszukania, taki jak nazwa lub słowo kluczowe.

Filtr schematu
schema string

Ogranicz wyniki do określonego schematu (np. Person).

Dołączone zestawy danych
include_dataset array

Zwracaj tylko jednostki z tych zestawów danych.

Wykluczone zestawy danych
exclude_dataset array

Wyklucz jednostki z tych zestawów danych.

Wykluczone schematy
exclude_schema array

Wyklucz jednostki tych typów schematów.

Zmieniono od daty
changed_since string

Uwzględnij tylko jednostki zaktualizowane od tej daty ISO.

Filtr kraju
countries array

Filtruj według kodów kraju (ISO 3166-1 alfa-2).

Filtr tematów
topics array

Ogranicz wyniki do jednostek oznaczonych tematami.

Filtr zestawów danych
datasets array

Filtruj według identyfikatorów zestawu danych.

Filtr pola
filter array

Użyj składni "field:value", aby filtrować pola, np. properties.birthDate:1985.

Limit wyników
limit integer

Maksymalna liczba wyników do zwrócenia (1–500).

Przesunięcie wyniku
offset integer

Uruchamianie przesunięcia dla stronicowanych wyników.

Kolejność sortowania
sort array

Sortuj wyniki według pola, np. score:desc.

Target (przestarzałe)
target string

Deprecated. Zamiast tego użyj parametru "topics".

Wyszukiwanie rozmyte
fuzzy boolean

Włącz dopasowywanie rozmytego tekstu (przybliżone wyszukiwanie).

Tryb prosty
simple boolean

Uprość wyniki, pomijając szczegółowe metadane.

Pola aspektów
facets array

Zwraca liczbę aspektów dla tych pól.

Operator filtru
filter_op string

Logika łączenia wielu filtrów (AND/OR).

Zwraca

SearchResponse
SearchResponse

Definicje

Algorithm

Nazwa Ścieżka Typ Opis
nazwa
name string

Nazwa zgodnego lub oceniania algorytmu.

opis
description string

Krótki opis tego, co robi algorytm.

features
features object

Deprecated. docs Zamiast tego użyj właściwości .

AlgorithmDocs
docs AlgorithmDocs

Dokumentacja algorytmu oceniania.

AlgorithmDocs

Dokumentacja algorytmu oceniania.

Nazwa Ścieżka Typ Opis
nazwa
name string
opis
description
konfig
config object
features
features object

AlgorithmResponse

Nazwa Ścieżka Typ Opis
Algorytmów
algorithms array of Algorithm
domyślny
default string
najlepszy
best string

EntityMatchResponse

Nazwa Ścieżka Typ Opis
Odpowiedzi
responses object
Matcher
matcher object

Informacje o dopasowaniu użytym do oceny tego żądania. Przestarzałe użyj punktu /algorithms końcowego.

limit
limit integer

JednostkaResponse

Nazwa Ścieżka Typ Opis
id
id string
napis
caption string
schemat
schema string
properties
properties object
zbiory danych
datasets array of string
referenty
referents array of string
miejsce docelowe
target boolean
first_seen
first_seen
last_seen
last_seen
last_change
last_change

FreebaseManifest

Nazwa Ścieżka Typ Opis
versions
versions array of string
nazwa
name string
identifierSpace
identifierSpace string
schemaSpace
schemaSpace string
dokumentacja
documentation string
batchSize
batchSize integer
FreebaseManifestView
view FreebaseManifestView
FreebaseManifestPreview
preview FreebaseManifestPreview
FreebaseManifestSuggest
suggest FreebaseManifestSuggest
FreebaseManifestExtend
extend FreebaseManifestExtend
defaultTypes
defaultTypes array of FreebaseType

FreebaseManifestExtend

Nazwa Ścieżka Typ Opis
FreebaseManifestExtendProposeProperties
propose_properties FreebaseManifestExtendProposeProperties
propose_settings
propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

Nazwa Ścieżka Typ Opis
nazwa
name string
etykieta
label string
typ
type string
domyślny
default
help_text
help_text string
choices
choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

Nazwa Ścieżka Typ Opis
id
id string
nazwa
name string

FreebaseManifestExtendProposeProperties

Nazwa Ścieżka Typ Opis
service_url
service_url string
service_path
service_path string

FreebaseManifestPreview

Nazwa Ścieżka Typ Opis
URL
url string
width
width integer
height
height integer

FreebaseManifestSuggest

Nazwa Ścieżka Typ Opis
FreebaseManifestSuggestType
entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
type FreebaseManifestSuggestType
FreebaseManifestSuggestType
property FreebaseManifestSuggestType

FreebaseManifestSuggestType

Nazwa Ścieżka Typ Opis
service_url
service_url string
service_path
service_path string

FreebaseManifestView

Nazwa Ścieżka Typ Opis
URL
url string

FreebaseType

Nazwa Ścieżka Typ Opis
id
id string
nazwa
name string
opis
description

SearchResponse

Nazwa Ścieżka Typ Opis
limit
limit integer
przesunąć
offset integer
TotalSpec
total TotalSpec
results
results array of EntityResponse
Aspekty
facets object

Statement

Nazwa Ścieżka Typ Opis
id
id string
entity_id
entity_id string
canonical_id
canonical_id string
rekwizyt
prop string
prop_type
prop_type string
schemat
schema string
value
value string
original_value
original_value
zestaw danych
dataset string
język
lang
first_seen
first_seen date-time
last_seen
last_seen date-time

StatementResponse

Nazwa Ścieżka Typ Opis
limit
limit integer
przesunąć
offset integer
TotalSpec
total TotalSpec
results
results array of Statement

StatusResponse

Nazwa Ścieżka Typ Opis
stan
status string

TotalSpec

Nazwa Ścieżka Typ Opis
value
value integer
relacja
relation string

obiekt

Jest to typ "object".