Aracılığıyla paylaş


OpenSanctions (Bağımsız Yayımcı) (Önizleme)

OpenSanctions API'si, küresel yaptırımları ve siyasi olarak kullanıma sunulan kişiler (PEP) veritabanını aramanıza ve sorgulamanıza olanak tanır. Varlık eşleştirme, metin araması, varlık alma ve ayrıntılı deyim düzeyi veriler için uç noktalar sağlar. Kişileri veya şirketleri tasdik listelerine karşı denetlemek veya OpenSanctions varlık grafiğini keşfetmek için kullanın.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standart Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Kamu bölgeleri
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Premium Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Power Automate Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim OpenSanctions
URL https://developments.substack.com
E-posta dan.romano@swolcat.com
Bağlayıcı Meta Verileri
Publisher krautrocker
Web sitesi https://www.opensanctions.org/
Gizlilik ilkesi https://www.opensanctions.org/docs/privacy/
Kategoriler Data

OpenSanctions

Genel Bakış

OpenSanctions API'leri, siyasi, cezai veya ekonomik çıkarları olan kişi ve şirketlerin küresel veritabanına erişim sağlar. Dünya genelinde yüzlerce tasdik listesinden, siyasi olarak kullanıma sunulan kişilerden (PEP) ve izleme listelerinden verileri toplar.

Varlıkları eşleştirmek, aramak ve getirmek, ilişkileri keşfetmek ve veri kümesi kapsamını analiz etmek için bu bağlayıcıyı kullanabilirsiniz.

daha fazla bilgi için OpenSanctions.org.

Yayımcı - Dan Romano (şişmiş)

Önkoşullar

Bu bağlayıcıyı kullanmak için OpenSanctions'tan bir API anahtarına ihtiyacınız olacaktır. Şu konumdan ücretsiz anahtara kaydolun: https://www.opensanctions.org/api/

Desteklenen İşlemler

Varlıkları veri kümesine göre eşleştirme

Varlıkları ada ve doğum tarihi, uyruk ve tanımlayıcılar gibi isteğe bağlı alanlara göre eşleştirin. Bu uç nokta benzer eşleştirmeyi destekler.

Veri kümesindeki varlıkları arama

Basit bir metin sorgusu kullanarak varlıkları arayın. İyileştirilmiş aramalar için filtreleri, konuları, ülkeleri ve veri kümelerini destekler.

Kimliğine göre varlık alma

İç içe ve ilgili öznitelikler dahil olmak üzere benzersiz tanımlayıcısına göre tek bir varlık kaydı alın.

Bitişik varlıkları alma

Belirtilen varlığa bitişik varlıkları (örneğin, ilişkilendirmeler, aile üyeleri veya ilgili şirketler) döndürür.

Özelliğe göre bitişik varlıkları alma

Belirli bir özellik için ilgili varlıkları döndürür (örneğin, familyPerson, ownershipOwner, membershipMember).

Veri kümesi kataloğunu alma

OpenSanctions aracılığıyla kullanılabilen tüm dizinlenmiş veri kümelerinin listesini alın.

Sistem durumunu alma

Hizmet kullanılabilirliğini doğrulamak için bir sistem durumu denetimi gerçekleştirin.

Eşleşen algoritmaları alma

Sistem tarafından kullanılan desteklenen varlık eşleştirme algoritmalarını listeleyin.

Dizin güncelleştirmesini zorla

Geçerli bir güncelleştirme belirteci ile yetkilendirilmişse yeniden dizin oluşturma işlemini tetikleyin.

Başlangıç Yapmak

  1. OpenSanctions.org'da bir hesap oluşturun.
  2. API anahtarı
  3. Power Automate veya Power Apps'te API anahtarınızı kullanarak yeni bir bağlantı oluşturun.
  4. Varlıkları aramak, eşleştirmek veya getirmek için bağlayıcının eylemlerini kullanın.

Kimlik Bilgilerini Alma

API anahtarı istemek için ziyaret edin https://www.opensanctions.org/api/ . Üst bilgide Authorization kullanılması gereken bir ApiKey değer alırsınız:

Yetkilendirme: ApiKey YOUR_API_KEY

Bilinen Sorunlar ve Sınırlamalar

  • Yanıt yapıları dinamiktir; iç içe değerlere erişmek için Power Automate'te "JSON Ayrıştır" kullanın.
  • search ve match uç noktaları, veri kümesi kapsamına bağlı olarak büyük yanıtlar döndürebilir.
  • Bazı uç noktalar için geçerli dataset bir parametre gerekir (örn. sanctions).
  • Desteklenmeyen alanlara göre sıralama (örneğin score) hataları tetikleyebilir.
  • API hız sınırları planınıza bağlı olarak uygulanabilir.

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim Türü Description Gerekli
API anahtarı securestring Bu API için api_key Doğru

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye

Eylemler

API sistem durumunu denetleme

API'nin erişilebilir ve çalışır durumda olduğunu onaylayan basit bir durum yanıtı döndürür. genellikle izleme araçları veya Kubernetes canlılık yoklamaları tarafından kullanılır.

Arama dizini hazır olup olmadığını denetleme

API'nin sorguları işlemeye hazır olup olmadığını belirtmek için arama dizininin durumunu döndürür. Başlatma ve dağıtıma hazır olma durumunu izlemek için kullanışlıdır.

Bir varlığa bitişik varlıkları alma

Bağlı kişiler, şirketler, tanımlayıcılar veya tasdikler gibi belirtilen varlığa bağlı varlıkları döndürür. OpenSanctions veri kümesindeki grafik ilişkilerini keşfetmek için kullanışlıdır.

Bir veri kümesi için varlıkları mutabık kıl

Google İyileştirme (OpenRefine) API'siyle uyumlu bir mutabakat uç noktası sağlar. OpenRefine gibi bir dış araçtan alınan veri kümesiyle varlık adlarını toplu eşleştirmek veya doğrulamak için bunu kullanın.

Desteklenen eşleşen algoritmaları alma

Varlık karşılaştırması ve sonuç derecelendirmesi için API tarafından kullanılan tüm desteklenen eşleştirme ve puanlama algoritmalarının listesini alır.

Dizin yeniden oluşturmayı zorlama

Arama dizininin el ile yeniden oluşturulmasını tetikler. Yetkilendirme için geçerli bir güncelleştirme belirteci gerektirir. Veri veya yapı değişiklikleri gerçekleştiğinde veri kümesini yenilemek için bunu kullanın.

Ham varlık deyimlerini alma

OpenSanctions veritabanından tek tek deyimler olarak ayrıntılı varlık verilerini döndürür. Her ifade, kaynak verilerden ayıklanan tek bir olgu (örneğin, ad, adres, doğum tarihi) temsil eder.

Kimliğine göre varlık alma

Sahiplik, ilişkilendirmeler ve bağlı özellikler gibi ilgili veriler de dahil olmak üzere kimliğiyle belirtilen bir varlığın tam kaydını döndürür.

Varlıkları bir veri kümesiyle eşleştirme

Benzer ad, doğum tarihi ve uyruk ölçütlerini kullanarak kişileri veya şirketleri bir veri kümesiyle eşleştirmek için bu uç noktayı kullanın. Güvenilirlik eşikleri olan puanlanmış eşleşme sonuçlarını döndürür.

Veri kümesi kataloğunu alma

OpenSanctions API'sindeki tüm kullanılabilir ve dizine alınan veri kümelerini içeren tam hizmet kataloğunu döndürür. Veri kümesi adlarını ve meta verilerini bulmak için kullanışlıdır.

Veri kümesindeki varlıkları arama

Varlıkları bir veri kümesi içinde ada veya anahtar sözcüke göre aramak için bu uç noktayı kullanın. Alan filtrelerini, benzer eşleştirmeyi ve isteğe bağlı yüz tanımayı destekler.

Özelliğe göre ilgili varlıkları alma

Sahiplik, aile bağları veya tanımlayıcılar gibi belirli bir özellik aracılığıyla belirli bir varlıkla ilgili varlıkları döndürür. Grafik ilişkilerini ayrıntılı olarak keşfetmek için kullanışlıdır.

API sistem durumunu denetleme

API'nin erişilebilir ve çalışır durumda olduğunu onaylayan basit bir durum yanıtı döndürür. genellikle izleme araçları veya Kubernetes canlılık yoklamaları tarafından kullanılır.

Döndürülenler

StatusResponse
StatusResponse

Arama dizini hazır olup olmadığını denetleme

API'nin sorguları işlemeye hazır olup olmadığını belirtmek için arama dizininin durumunu döndürür. Başlatma ve dağıtıma hazır olma durumunu izlemek için kullanışlıdır.

Döndürülenler

StatusResponse
StatusResponse

Bir varlığa bitişik varlıkları alma

Bağlı kişiler, şirketler, tanımlayıcılar veya tasdikler gibi belirtilen varlığa bağlı varlıkları döndürür. OpenSanctions veri kümesindeki grafik ilişkilerini keşfetmek için kullanışlıdır.

Parametreler

Name Anahtar Gerekli Tür Description
Varlık Kimliği
entity_id True string

Bağlantıları alınacak varlığın benzersiz kimliği.

Sıralama düzeni
sort array

Sonuçları alana göre sıralayın; örneğin, score:desc.

Sonuç sınırı
limit integer

Döndürülecek en fazla ilişkili varlık sayısı (1-500).

Sonuç uzaklığı
offset integer

Sayfalandırılmış ilgili varlıklar için başlangıç uzaklığı.

Döndürülenler

response
object

Bir veri kümesi için varlıkları mutabık kıl

Google İyileştirme (OpenRefine) API'siyle uyumlu bir mutabakat uç noktası sağlar. OpenRefine gibi bir dış araçtan alınan veri kümesiyle varlık adlarını toplu eşleştirmek veya doğrulamak için bunu kullanın.

Parametreler

Name Anahtar Gerekli Tür Description
Hedef veri kümesi
dataset True string

Mutabık olunacak veri kümesi veya koleksiyon adı.

Döndürülenler

FreebaseManifest
FreebaseManifest

Desteklenen eşleşen algoritmaları alma

Varlık karşılaştırması ve sonuç derecelendirmesi için API tarafından kullanılan tüm desteklenen eşleştirme ve puanlama algoritmalarının listesini alır.

Döndürülenler

AlgorithmResponse
AlgorithmResponse

Dizin yeniden oluşturmayı zorlama

Arama dizininin el ile yeniden oluşturulmasını tetikler. Yetkilendirme için geçerli bir güncelleştirme belirteci gerektirir. Veri veya yapı değişiklikleri gerçekleştiğinde veri kümesini yenilemek için bunu kullanın.

Parametreler

Name Anahtar Gerekli Tür Description
Belirteci güncelleştirme
token string

Dizin yeniden derlemesini yetkilendirmek için gereken API belirteci.

Eşitleme modu
sync boolean

Zaman uyumlu olarak çalıştırın ve dizin tamamlanmasını bekleyin.

Döndürülenler

StatusResponse
StatusResponse

Ham varlık deyimlerini alma

OpenSanctions veritabanından tek tek deyimler olarak ayrıntılı varlık verilerini döndürür. Her ifade, kaynak verilerden ayıklanan tek bir olgu (örneğin, ad, adres, doğum tarihi) temsil eder.

Parametreler

Name Anahtar Gerekli Tür Description
Veri kümesi adı
dataset string

Sonuçları bu veri kümesindeki deyimlerle sınırlayın.

Varlık Kimliği
entity_id string

Bu varlık kimliğine bağlı return deyimleri.

Kurallı Kimlik
canonical_id string

Kurallı varlık kimliği için fetch deyimleri.

Özellik filtresi
prop string

Deyimleri özellik adına göre filtreleyin.

Özellik değeri
value string

Bu özellik değerini içeren filtre deyimleri.

Şema filtresi
schema string

Deyimleri belirli bir şemanın varlıklarıyla kısıtlayın.

Sıralama düzeni
sort array

Sonuçları alana göre sıralayın; örneğin, zaman damgası:desc.

Sonuç sınırı
limit integer

Döndürülecek en fazla deyim sayısı (1–5000).

Sonuç uzaklığı
offset integer

Sayfalandırılmış sonuçlar için başlangıç uzaklığı.

Döndürülenler

StatementResponse
StatementResponse

Kimliğine göre varlık alma

Sahiplik, ilişkilendirmeler ve bağlı özellikler gibi ilgili veriler de dahil olmak üzere kimliğiyle belirtilen bir varlığın tam kaydını döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Varlık Kimliği
entity_id True string

Alınacak varlığın benzersiz kimliği.

İç içe varlıkları dahil et
nested boolean

Yanıta bağlı veya ilgili varlıkları ekleyin.

Döndürülenler

Dinamik JSON nesnesi. Doğrulama olmadan tüm alan türlerine izin verir.

response
object

Varlıkları bir veri kümesiyle eşleştirme

Benzer ad, doğum tarihi ve uyruk ölçütlerini kullanarak kişileri veya şirketleri bir veri kümesiyle eşleştirmek için bu uç noktayı kullanın. Güvenilirlik eşikleri olan puanlanmış eşleşme sonuçlarını döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Hedef veri kümesi adı
dataset True string

Eşleştirme sorgusunu çalıştırmak için veri kümesi veya koleksiyon adı.

Sonuç sınırı
limit integer

Döndürülecek en fazla eşleşme sayısı (1-500).

Eşik değeri
threshold double

Sonucu dahil etmek için en düşük puan (0-1).

Kesme puanı
cutoff double

En iyi eşleşme kesme için en düşük kabul edilebilir puan.

Algoritma sürümü
algorithm string

Kullanılacak eşleşen algoritma, örneğin logic-v1.

Dahil edilen veri kümeleri
include_dataset array

Eşleşmeye açıkça dahil etmek için veri kümeleri.

Dışlanan şemalar
exclude_schema array

Eşleme işleminin dışında tutulacak şemalar.

Dışlanan veri kümeleri
exclude_dataset array

Eşleştirme işleminin dışında tutulacak veri kümeleri.

Konu filtresi
topics array

Eşleşmeleri bu konularla etiketlenmiş varlıklarla kısıtlayın.

Tarihten bu yana değiştirildi
changed_since string

Yalnızca bu ISO tarihinden bu yana değiştirilen varlıkları dahil edin.

Dışlanan varlık kimlikleri
exclude_entity_ids array

Eşleştirme sırasında yoksaymak için varlık kimlikleri. Hatalı pozitifleri veya daha önce gözden geçirilen varlıkları filtrelemek için kullanın.

İçerik türü üst bilgisi
Content-Type string

İstek gövdesinin içerik türü (application/json).

Ağırlık
weights object
config
config object

Algoritmaya özgü yapılandırma parametreleri.

queries
queries True object

Döndürülenler

EntityMatchResponse
EntityMatchResponse

Veri kümesi kataloğunu alma

OpenSanctions API'sindeki tüm kullanılabilir ve dizine alınan veri kümelerini içeren tam hizmet kataloğunu döndürür. Veri kümesi adlarını ve meta verilerini bulmak için kullanışlıdır.

Döndürülenler

response
object

Veri kümesindeki varlıkları arama

Varlıkları bir veri kümesi içinde ada veya anahtar sözcüke göre aramak için bu uç noktayı kullanın. Alan filtrelerini, benzer eşleştirmeyi ve isteğe bağlı yüz tanımayı destekler.

Parametreler

Name Anahtar Gerekli Tür Description
Hedef veri kümesi
dataset True string

İçinde aranacak veri kümesi veya koleksiyon.

Arama sorgusu
q string

Ad veya anahtar sözcük gibi aranacak metin.

Şema filtresi
schema string

Sonuçları belirli bir şemayla (örneğin, Kişi) kısıtlayın.

Dahil edilen veri kümeleri
include_dataset array

Yalnızca bu veri kümelerindeki varlıkları döndürür.

Dışlanan veri kümeleri
exclude_dataset array

Varlıkları bu veri kümelerinden hariç tutun.

Dışlanan şemalar
exclude_schema array

Bu şema türlerinin varlıklarını hariç tutun.

Tarihten bu yana değiştirildi
changed_since string

Yalnızca bu ISO tarihinden bu yana güncelleştirilen varlıkları dahil edin.

Ülke filtresi
countries array

Ülke kodlarına göre filtreleyin (ISO 3166-1 alfa-2).

Konu filtresi
topics array

Sonuçları konu başlıklarıyla etiketlenmiş varlıklarla kısıtlayın.

Veri kümeleri filtresi
datasets array

Veri kümesi tanımlayıcılarına göre filtreleyin.

Alan filtresi
filter array

Alanları filtrelemek için 'field:value' söz dizimlerini kullanın; örneğin properties.birthDate:1985.

Sonuç sınırı
limit integer

Döndürülecek en fazla sonuç sayısı (1-500).

Sonuç uzaklığı
offset integer

Sayfalanmış sonuçlar için başlangıç uzaklığı.

Sıralama düzeni
sort array

Sonuçları alana göre sıralayın; örneğin, score:desc.

Hedef (kullanım dışı)
target string

Deprecated. Bunun yerine 'topics' parametresini kullanın.

Benzer arama
fuzzy boolean

Benzer metin eşleştirmeyi (yaklaşık arama) etkinleştirin.

Basit modu
simple boolean

Ayrıntılı meta verileri atlayarak sonuçları basitleştirin.

Model alanları
facets array

Bu alanlar için model sayılarını döndürür.

Filtre operatörü
filter_op string

Birden çok filtreyi (AND/OR) birleştirme mantığı.

Döndürülenler

AramaResponse
SearchResponse

Özelliğe göre ilgili varlıkları alma

Sahiplik, aile bağları veya tanımlayıcılar gibi belirli bir özellik aracılığıyla belirli bir varlıkla ilgili varlıkları döndürür. Grafik ilişkilerini ayrıntılı olarak keşfetmek için kullanışlıdır.

Parametreler

Name Anahtar Gerekli Tür Description
Varlık Kimliği
entity_id True string

İlgili öğeleri getirilmeyen varlığın benzersiz kimliği.

Özellik adı
property_name True string

İlgili varlıkları getirmek için kullanılan özellik adı.

Sıralama düzeni
sort array

İlgili varlıkları alana göre sıralayın; örneğin, score:desc.

Sonuç sınırı
limit integer

Döndürülecek en fazla ilişkili varlık sayısı (1-500).

Sonuç uzaklığı
offset integer

Sayfalandırılmış ilgili sonuçlar için başlangıç uzaklığı.

Döndürülenler

dinamik JSON yapısı, ilgili varlıkların tövbesini sağlar. Her özellik dize dizileri veya iç içe varlık nesneleri içerebilir.

response
object

Tanımlar

Algorithm

Name Yol Tür Description
name
name string

Eşleşen veya puanlama algoritmasının adı.

açıklama
description string

Algoritmanın ne yaptığının kısa açıklaması.

features
features object

Deprecated. docs Bunun yerine özelliğini kullanın.

AlgorithmDocs
docs AlgorithmDocs

Puanlama algoritması için belgeler.

AlgorithmDocs

Puanlama algoritması için belgeler.

Name Yol Tür Description
name
name string
açıklama
description
config
config object
features
features object

AlgorithmResponse

Name Yol Tür Description
Algoritma
algorithms array of Algorithm
default
default string
en iyi
best string

EntityMatchResponse

Name Yol Tür Description
Yanıt
responses object
Eşleştir -ici
matcher object

Bu isteği puanlarken kullanılan eşleştirici hakkında bilgi. Kullanım dışı bırakıldı, bunun yerine uç nokta kullanın /algorithms .

limit
limit integer

EntityResponse

Name Yol Tür Description
kimlik
id string
açıklama
caption string
şema
schema string
properties
properties object
veri kümeleri
datasets array of string
başvurular
referents array of string
target
target boolean
first_seen
first_seen
last_seen
last_seen
last_change
last_change

FreebaseManifest

Name Yol Tür Description
versions
versions array of string
name
name string
identifierSpace
identifierSpace string
schemaSpace
schemaSpace string
Belge
documentation string
yığın boyutu
batchSize integer
FreebaseManifestView
view FreebaseManifestView
FreebaseManifestPreview
preview FreebaseManifestPreview
FreebaseManifestSuggest
suggest FreebaseManifestSuggest
FreebaseManifestExtend
extend FreebaseManifestExtend
defaultTypes
defaultTypes array of FreebaseType

FreebaseManifestExtend

Name Yol Tür Description
FreebaseManifestExtendProposeProperties
propose_properties FreebaseManifestExtendProposeProperties
propose_settings
propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

Name Yol Tür Description
name
name string
label
label string
type
type string
default
default
help_text
help_text string
choices
choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

Name Yol Tür Description
kimlik
id string
name
name string

FreebaseManifestExtendProposeProperties

Name Yol Tür Description
service_url
service_url string
service_path
service_path string

FreebaseManifestPreview

Name Yol Tür Description
url
url string
width
width integer
height
height integer

FreebaseManifestSuggest

Name Yol Tür Description
FreebaseManifestSuggestType
entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
type FreebaseManifestSuggestType
FreebaseManifestSuggestType
property FreebaseManifestSuggestType

FreebaseManifestSuggestType

Name Yol Tür Description
service_url
service_url string
service_path
service_path string

FreebaseManifestView

Name Yol Tür Description
url
url string

FreebaseType

Name Yol Tür Description
kimlik
id string
name
name string
açıklama
description

AramaResponse

Name Yol Tür Description
limit
limit integer
offset
offset integer
TotalSpec
total TotalSpec
results
results array of EntityResponse
Yön -leriyle
facets object

Statement

Name Yol Tür Description
kimlik
id string
entity_id
entity_id string
canonical_id
canonical_id string
Pervane
prop string
prop_type
prop_type string
şema
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

Name Yol Tür Description
limit
limit integer
offset
offset integer
TotalSpec
total TotalSpec
results
results array of Statement

StatusResponse

Name Yol Tür Description
statü
status string

TotalSpec

Name Yol Tür Description
value
value integer
ilişki
relation string

object

Bu , 'object' türüdür.