다음을 통해 공유


OpenSanctions(Independent Publisher)(미리 보기)

OpenSanctions API를 사용하면 전역 제재 및 PEP(정치적으로 노출된 사람) 데이터베이스를 검색하고 쿼리할 수 있습니다. 엔터티 일치, 텍스트 검색, 엔터티 검색 및 세분화된 문 수준 데이터에 대한 엔드포인트를 제공합니다. 이를 사용하여 제재 목록에 대해 사람 또는 회사를 확인하거나 OpenSanctions 엔터티 그래프를 탐색합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate (파워 오토메이트) Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 OpenSanctions
URL https://developments.substack.com
전자 메일 dan.romano@swolcat.com
커넥터 메타데이터
게시자 크라우트로커
웹 사이트 https://www.opensanctions.org/
개인 정보 보호 정책 https://www.opensanctions.org/docs/privacy/
카테고리 데이터

OpenSanctions

개요

OpenSanctions API는 정치적, 범죄적 또는 경제적 이익을 가진 사람과 회사의 글로벌 데이터베이스에 대한 액세스를 제공합니다. 수백 개의 제재 목록, 정치적으로 노출된 사람(PEP) 및 전 세계 감시 목록의 데이터를 집계합니다.

이 커넥터를 사용하여 엔터티를 일치, 검색 및 가져오고, 관계를 탐색하고, 데이터 세트 범위를 분석할 수 있습니다.

OpenSanctions.org 자세히 알아보세요.

Publisher - Dan Romano(swolcat)

필수 조건

이 커넥터를 사용하려면 OpenSanctions의 API 키가 필요합니다. 다음 위치에서 무료 키를 등록합니다. https://www.opensanctions.org/api/

지원되는 작업

데이터 세트별로 엔터티 일치

이름 및 선택적 필드(예: 생년월일, 국적 및 식별자)를 기준으로 엔터티를 일치합니다. 이 엔드포인트는 유사 항목 일치를 지원합니다.

데이터 세트의 엔터티 검색

간단한 텍스트 쿼리를 사용하여 엔터티를 검색합니다. 구체화된 검색을 위한 필터, 토픽, 국가 및 데이터 세트를 지원합니다.

ID로 엔터티 가져오기

중첩 및 관련 특성을 포함하여 고유 식별자를 사용하여 단일 엔터티 레코드를 검색합니다.

인접한 엔터티 가져오기

지정된 엔터티(예: 동료, 가족 구성원 또는 관련 회사)에 인접한 엔터티를 반환합니다.

속성별 인접 엔터티 가져오기

특정 속성(예: familyPerson, ownershipOwner, membershipMember)에 대한 관련 엔터티를 반환합니다.

데이터 세트 카탈로그 가져오기

OpenSanctions를 통해 사용할 수 있는 인덱싱된 모든 데이터 세트의 목록을 검색합니다.

시스템 상태 가져오기

시스템 상태 검사를 수행하여 서비스 가용성을 확인합니다.

일치하는 알고리즘 가져오기

시스템에서 사용하는 지원되는 엔터티 일치 알고리즘을 나열합니다.

인덱스 업데이트 강제 적용

유효한 업데이트 토큰으로 권한이 부여된 경우 다시 인덱싱 작업을 트리거합니다.

시작하기

  1. OpenSanctions.org 계정을 만듭니다.
  2. API 키
  3. Power Automate 또는 Power Apps에서 API 키를 사용하여 새 연결을 만듭니다.
  4. 커넥터의 작업을 사용하여 엔터티를 검색, 일치 또는 페치합니다.

자격 증명 가져오기

API 키를 요청하려면 방문 https://www.opensanctions.org/api/ 하세요. 헤더에 ApiKey 사용해야 하는 값이 Authorization 표시됩니다.

권한 부여: ApiKey YOUR_API_KEY

알려진 문제 및 제한 사항

  • 응답 구조는 동적입니다. Power Automate에서 "JSON 구문 분석"을 사용하여 중첩된 값에 액세스합니다.
  • match 엔드포인트는 search 데이터 세트 범위에 따라 큰 응답을 반환할 수 있습니다.
  • 일부 엔드포인트에는 유효한 dataset 매개 변수(예: sanctions)가 필요합니다.
  • 지원되지 않는 필드(예: score)로 정렬하면 오류가 트리거될 수 있습니다.
  • API 속도 제한은 계획에 따라 적용될 수 있습니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
API 키 시큐어스트링 (보안 문자열) 이 api에 대한 api_key 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

API 상태 확인

API에 연결할 수 있고 작동할 수 있는지 확인하는 간단한 상태 응답을 반환합니다. 일반적으로 도구 또는 Kubernetes 활동성 프로브를 모니터링하는 데 사용됩니다.

ID로 엔터티 가져오기

소유권, 연결 및 연결된 속성과 같은 관련 데이터를 포함하여 ID로 지정된 엔터티의 전체 레코드를 반환합니다.

검색 인덱스 준비 상태 확인

검색 인덱스의 상태를 반환하여 API가 쿼리를 처리할 준비가 되었는지 여부를 나타냅니다. 시작 및 배포 준비 상태를 모니터링하는 데 유용합니다.

데이터 세트 카탈로그 가져오기

OpenSanctions API에서 사용 가능한 데이터 세트와 인덱싱된 모든 데이터 세트를 포함하는 전체 서비스 카탈로그를 반환합니다. 데이터 세트 이름 및 메타데이터를 검색하는 데 유용합니다.

데이터 세트에 대한 엔터티 조정

Google Refine(OpenRefine) API와 호환되는 조정 엔드포인트를 제공합니다. OpenRefine과 같은 외부 도구에서 데이터 세트와 엔터티 이름을 대량으로 일치하거나 확인하는 데 사용합니다.

데이터 세트와 엔터티 일치

이 엔드포인트를 사용하여 유사 항목 이름, 생년월일 및 국적 기준을 사용하여 사용자 또는 회사를 데이터 세트와 일치시킬 수 있습니다. 신뢰도 임계값을 사용하여 점수가 매칭된 일치 결과를 반환합니다.

데이터 세트의 엔터티 검색

이 엔드포인트를 사용하여 데이터 세트 내에서 이름 또는 키워드로 엔터티를 검색합니다. 필드 필터, 유사 항목 일치 및 선택적 패싯을 지원합니다.

속성별로 관련 엔터티 가져오기

소유권, 패밀리 관계 또는 식별자와 같은 특정 속성을 통해 지정된 엔터티와 관련된 엔터티를 반환합니다. 그래프 관계를 자세히 탐색하는 데 유용합니다.

엔터티에 인접한 엔터티 가져오기

연결된 사람, 회사, 식별자 또는 제재와 같이 지정된 엔터티에 연결된 엔터티를 반환합니다. OpenSanctions 데이터 세트에서 그래프 관계를 탐색하는 데 유용합니다.

원시 엔터티 문 가져오기

OpenSanctions 데이터베이스에서 세분화된 엔터티 데이터를 개별 문으로 반환합니다. 각 문은 원본 데이터에서 추출된 단일 팩트(예: 이름, 주소, 생년월일)를 나타냅니다.

인덱스 다시 생성 강제 적용

검색 인덱스의 수동 다시 작성을 트리거합니다. 권한 부여를 위해 유효한 업데이트 토큰이 필요합니다. 이를 사용하여 데이터 또는 구조 변경이 발생할 때 데이터 세트를 새로 고칩니다.

지원되는 일치 알고리즘 가져오기

엔터티 비교 및 결과 순위를 위해 API에서 사용하는 지원되는 모든 일치 및 점수 매기기 알고리즘 목록을 검색합니다.

API 상태 확인

API에 연결할 수 있고 작동할 수 있는지 확인하는 간단한 상태 응답을 반환합니다. 일반적으로 도구 또는 Kubernetes 활동성 프로브를 모니터링하는 데 사용됩니다.

반환

StatusResponse
StatusResponse

ID로 엔터티 가져오기

소유권, 연결 및 연결된 속성과 같은 관련 데이터를 포함하여 ID로 지정된 엔터티의 전체 레코드를 반환합니다.

매개 변수

Name 필수 형식 Description
개체 ID
entity_id True string

검색할 엔터티의 고유 ID입니다.

중첩된 엔터티 포함
nested boolean

응답에 연결된 엔터티 또는 관련 엔터티를 포함합니다.

반환

동적 JSON 개체입니다. 유효성 검사 없이 모든 필드 형식을 허용합니다.

response
object

검색 인덱스 준비 상태 확인

검색 인덱스의 상태를 반환하여 API가 쿼리를 처리할 준비가 되었는지 여부를 나타냅니다. 시작 및 배포 준비 상태를 모니터링하는 데 유용합니다.

반환

StatusResponse
StatusResponse

데이터 세트 카탈로그 가져오기

OpenSanctions API에서 사용 가능한 데이터 세트와 인덱싱된 모든 데이터 세트를 포함하는 전체 서비스 카탈로그를 반환합니다. 데이터 세트 이름 및 메타데이터를 검색하는 데 유용합니다.

반환

response
object

데이터 세트에 대한 엔터티 조정

Google Refine(OpenRefine) API와 호환되는 조정 엔드포인트를 제공합니다. OpenRefine과 같은 외부 도구에서 데이터 세트와 엔터티 이름을 대량으로 일치하거나 확인하는 데 사용합니다.

매개 변수

Name 필수 형식 Description
대상 데이터 세트
dataset True string

조정할 데이터 세트 또는 컬렉션 이름입니다.

반환

FreebaseManifest
FreebaseManifest

데이터 세트와 엔터티 일치

이 엔드포인트를 사용하여 유사 항목 이름, 생년월일 및 국적 기준을 사용하여 사용자 또는 회사를 데이터 세트와 일치시킬 수 있습니다. 신뢰도 임계값을 사용하여 점수가 매칭된 일치 결과를 반환합니다.

매개 변수

Name 필수 형식 Description
대상 데이터 세트 이름
dataset True string

일치 쿼리를 실행할 데이터 세트 또는 컬렉션 이름입니다.

결과 제한
limit integer

반환할 최대 일치 항목 수(1-500)입니다.

일치 기준값
threshold double

결과를 포함할 최소 점수(0-1)입니다.

컷오프 점수
cutoff double

최상의 경기 컷오프에 허용되는 최소 점수입니다.

알고리즘 버전
algorithm string

사용할 일치 알고리즘(예: logic-v1)입니다.

포함된 데이터 세트
include_dataset array

일치 항목에 명시적으로 포함할 데이터 세트입니다.

제외된 스키마
exclude_schema array

일치 프로세스에서 제외할 스키마입니다.

제외된 데이터 세트
exclude_dataset array

일치 프로세스에서 제외할 데이터 세트입니다.

항목 필터
topics array

이러한 항목으로 태그가 지정된 엔터티로 일치 항목을 제한합니다.

날짜 이후 변경됨
changed_since string

이 ISO 날짜 이후 변경된 엔터티만 포함합니다.

제외된 엔터티 ID
exclude_entity_ids array

일치하는 동안 무시할 엔터티 ID입니다. 가양성 또는 이전에 검토한 엔터티를 필터링하는 데 사용합니다.

콘텐츠 형식 헤더
Content-Type string

요청 본문의 콘텐츠 형식(애플리케이션/json)입니다.

무게
weights object
config
config object

알고리즘별 구성 매개 변수입니다.

queries
queries True object

반환

EntityMatchResponse
EntityMatchResponse

데이터 세트의 엔터티 검색

이 엔드포인트를 사용하여 데이터 세트 내에서 이름 또는 키워드로 엔터티를 검색합니다. 필드 필터, 유사 항목 일치 및 선택적 패싯을 지원합니다.

매개 변수

Name 필수 형식 Description
대상 데이터 세트
dataset True string

검색할 데이터 세트 또는 컬렉션입니다.

검색어
q string

검색할 텍스트(예: 이름 또는 키워드)입니다.

스키마 필터
schema string

결과를 특정 스키마(예: Person)로 제한합니다.

포함된 데이터 세트
include_dataset array

이러한 데이터 세트의 엔터티만 반환합니다.

제외된 데이터 세트
exclude_dataset array

이러한 데이터 세트의 엔터티를 제외합니다.

제외된 스키마
exclude_schema array

이러한 스키마 형식의 엔터티를 제외합니다.

날짜 이후 변경됨
changed_since string

이 ISO 날짜 이후 업데이트된 엔터티만 포함합니다.

국가 필터
countries array

국가 코드(ISO 3166-1 alpha-2)로 필터링합니다.

항목 필터
topics array

토픽으로 태그가 지정된 엔터티로 결과를 제한합니다.

데이터 세트 필터
datasets array

데이터 세트 식별자를 사용하여 필터링합니다.

필드 필터
filter array

'field:value' 구문을 사용하여 필드를 필터링합니다(예: properties.birthDate:1985).

결과 제한
limit integer

반환할 최대 결과 수(1~500개)입니다.

결과 오프셋
offset integer

페이징된 결과에 대한 시작 오프셋입니다.

정렬 순서
sort array

결과를 필드별로 정렬합니다(예: score:desc).

대상(사용되지 않음)
target string

Deprecated. 대신 'topics' 매개 변수를 사용합니다.

유사 항목 검색
fuzzy boolean

유사 항목 텍스트 일치를 사용하도록 설정합니다(대략적인 검색).

단순 모드
simple boolean

자세한 메타데이터를 건너뛰어 결과를 간소화합니다.

패싯 필드
facets array

이러한 필드에 대한 패싯 수를 반환합니다.

필터 연산자
filter_op string

여러 필터(AND/OR)를 결합하는 논리입니다.

반환

SearchResponse
SearchResponse

속성별로 관련 엔터티 가져오기

소유권, 패밀리 관계 또는 식별자와 같은 특정 속성을 통해 지정된 엔터티와 관련된 엔터티를 반환합니다. 그래프 관계를 자세히 탐색하는 데 유용합니다.

매개 변수

Name 필수 형식 Description
개체 ID
entity_id True string

관련 항목을 가져올 엔터티의 고유 ID입니다.

속성 이름
property_name True string

관련 엔터티를 가져오는 데 사용되는 속성 이름입니다.

정렬 순서
sort array

관련 엔터티를 필드별로 정렬합니다(예: score:desc).

결과 제한
limit integer

반환할 관련 엔터티의 최대 수(1-500)입니다.

결과 오프셋
offset integer

페이지를 매긴 관련 결과에 대한 시작 오프셋입니다.

반환

관련된 엔터티를 회개하는 동적 JSON 구조입니다. 각 속성에는 문자열 또는 중첩된 엔터티 개체의 배열이 포함될 수 있습니다.

response
object

엔터티에 인접한 엔터티 가져오기

연결된 사람, 회사, 식별자 또는 제재와 같이 지정된 엔터티에 연결된 엔터티를 반환합니다. OpenSanctions 데이터 세트에서 그래프 관계를 탐색하는 데 유용합니다.

매개 변수

Name 필수 형식 Description
개체 ID
entity_id True string

연결을 검색할 엔터티의 고유 ID입니다.

정렬 순서
sort array

결과를 필드별로 정렬합니다(예: score:desc).

결과 제한
limit integer

반환할 관련 엔터티의 최대 수(1-500)입니다.

결과 오프셋
offset integer

페이지를 매긴 관련 엔터티의 시작 오프셋입니다.

반환

response
object

원시 엔터티 문 가져오기

OpenSanctions 데이터베이스에서 세분화된 엔터티 데이터를 개별 문으로 반환합니다. 각 문은 원본 데이터에서 추출된 단일 팩트(예: 이름, 주소, 생년월일)를 나타냅니다.

매개 변수

Name 필수 형식 Description
데이터 세트 이름
dataset string

결과를 이 데이터 세트의 문으로 제한합니다.

개체 ID
entity_id string

이 엔터티 ID에 연결된 문을 반환합니다.

정식 ID
canonical_id string

정식 엔터티 ID에 대한 Fetch 문입니다.

속성 필터
prop string

속성 이름으로 문을 필터링합니다.

속성 값
value string

이 속성 값을 포함하는 필터 문입니다.

스키마 필터
schema string

지정된 스키마의 엔터티로 문을 제한합니다.

정렬 순서
sort array

결과를 필드별로 정렬합니다(예: timestamp:desc).

결과 제한
limit integer

반환할 최대 문 수(1-5000)입니다.

결과 오프셋
offset integer

페이지를 매긴 결과에 대한 시작 오프셋입니다.

반환

StatementResponse
StatementResponse

인덱스 다시 생성 강제 적용

검색 인덱스의 수동 다시 작성을 트리거합니다. 권한 부여를 위해 유효한 업데이트 토큰이 필요합니다. 이를 사용하여 데이터 또는 구조 변경이 발생할 때 데이터 세트를 새로 고칩니다.

매개 변수

Name 필수 형식 Description
토큰 업데이트
token string

인덱스 다시 작성 권한을 부여하는 데 필요한 API 토큰입니다.

동기화 모드
sync boolean

동기적으로 실행하고 인덱스 완성을 기다립니다.

반환

StatusResponse
StatusResponse

지원되는 일치 알고리즘 가져오기

엔터티 비교 및 결과 순위를 위해 API에서 사용하는 지원되는 모든 일치 및 점수 매기기 알고리즘 목록을 검색합니다.

반환

AlgorithmResponse
AlgorithmResponse

정의

알고리즘

Name 경로 형식 Description
이름
name string

일치 또는 점수 매기기 알고리즘의 이름입니다.

description
description string

알고리즘이 수행하는 작업을 간단히 설명합니다.

features
features object

Deprecated. 대신 docs 속성을 사용합니다.

AlgorithmDocs
docs AlgorithmDocs

점수 매기기 알고리즘에 대한 설명서입니다.

AlgorithmDocs

점수 매기기 알고리즘에 대한 설명서입니다.

Name 경로 형식 Description
이름
name string
description
description
config
config object
features
features object

AlgorithmResponse

Name 경로 형식 Description
알고리즘
algorithms array of Algorithm
default
default string
제일
best string

EntityMatchResponse

Name 경로 형식 Description
응답
responses object
매처
matcher object

이 요청의 점수를 매기는 데 사용된 선택기 정보입니다. 사용되지 않고 대신 엔드포인트를 사용합니다 /algorithms .

limit
limit integer

EntityResponse

Name 경로 형식 Description
아이디
id string
캡션
caption string
schema(스키마)
schema string
properties
properties object
데이터세트
datasets array of string
참조
referents array of string
target
target boolean
first_seen
first_seen
last_seen
last_seen
last_change
last_change

FreebaseManifest

Name 경로 형식 Description
versions
versions array of string
이름
name string
identifierSpace
identifierSpace string
schemaSpace
schemaSpace string
문서조사
documentation string
batchSize
batchSize integer
FreebaseManifestView
view FreebaseManifestView
FreebaseManifestPreview
preview FreebaseManifestPreview
FreebaseManifestSuggest
suggest FreebaseManifestSuggest
FreebaseManifestExtend
extend FreebaseManifestExtend
defaultTypes
defaultTypes array of FreebaseType

FreebaseManifestExtend

Name 경로 형식 Description
FreebaseManifestExtendProposeProperties
propose_properties FreebaseManifestExtendProposeProperties
propose_settings
propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

Name 경로 형식 Description
이름
name string
label
label string
type
type string
default
default
help_text
help_text string
choices
choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

Name 경로 형식 Description
아이디
id string
이름
name string

FreebaseManifestExtendProposeProperties

Name 경로 형식 Description
service_url
service_url string
service_path
service_path string

FreebaseManifestPreview

Name 경로 형식 Description
url
url string
width
width integer
height
height integer

FreebaseManifestSuggest

Name 경로 형식 Description
FreebaseManifestSuggestType
entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
type FreebaseManifestSuggestType
FreebaseManifestSuggestType
property FreebaseManifestSuggestType

FreebaseManifestSuggestType

Name 경로 형식 Description
service_url
service_url string
service_path
service_path string

FreebaseManifestView

Name 경로 형식 Description
url
url string

FreebaseType

Name 경로 형식 Description
아이디
id string
이름
name string
description
description

SearchResponse

Name 경로 형식 Description
limit
limit integer
offset
offset integer
TotalSpec
total TotalSpec
results
results array of EntityResponse
측면
facets object

Statement

Name 경로 형식 Description
아이디
id string
entity_id
entity_id string
canonical_id
canonical_id string
소품
prop string
prop_type
prop_type string
schema(스키마)
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 경로 형식 Description
limit
limit integer
offset
offset integer
TotalSpec
total TotalSpec
results
results array of Statement

StatusResponse

Name 경로 형식 Description
status
status string

TotalSpec

Name 경로 형식 Description
value
value integer
관련
relation string

객체

'object' 형식입니다.