Поделиться через

OpenSanctions (независимый издатель) (предварительная версия)

API OpenSanctions позволяет искать и запрашивать глобальные санкции и политическую базу данных лиц (PEP). Она предоставляет конечные точки для сопоставления сущностей, поиска текста, извлечения сущностей и детализированных данных на уровне инструкций. Используйте его для проверки пользователей или компаний против списков санкций или изучения графа сущностей OpenSanctions.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя OpenSanctions
URL https://developments.substack.com
Адрес электронной почты dan.romano@swolcat.com
Метаданные соединителя
Publisher krautrocker
Website https://www.opensanctions.org/
Политика конфиденциальности https://www.opensanctions.org/docs/privacy/
Категории Данные

OpenSanctions

Обзор

API OpenSanctions предоставляет доступ к глобальной базе данных лиц и компаний политических, преступных или экономических интересов. Он объединяет данные из сотен списков санкций, политически подверженных лиц (PEPs) и списков наблюдения по всему миру.

Этот соединитель можно использовать для сопоставления, поиска и получения сущностей, изучения связей и анализа охвата набора данных.

Дополнительные сведения см. в OpenSanctions.org.

Издатель — Дэн Романо (swolcat)

Предпосылки

Для использования этого соединителя потребуется ключ API из OpenSanctions. Зарегистрируйтесь для бесплатного ключа по адресу: https://www.opensanctions.org/api/

Поддерживаемые операции

Сопоставление сущностей по набору данных

Сопоставление сущностей на основе имен и необязательных полей, таких как дата рождения, национальность и идентификаторы. Эта конечная точка поддерживает нечеткое сопоставление.

Поиск сущностей в наборе данных

Поиск сущностей с помощью простого текстового запроса. Поддерживает фильтры, разделы, страны и наборы данных для уточненного поиска.

Получение сущности по идентификатору

Извлеките запись одной сущности по уникальному идентификатору, включая вложенные и связанные атрибуты.

Получение смежных сущностей

Возвращает сущности, смежные с указанной сущностью (например, партнеры, члены семьи или связанные компании).

Получение смежных сущностей по свойству

Возвращать связанные сущности для определенного свойства (например, familyPerson, propertyOwner, membershipMember).

Получение каталога наборов данных

Получите список всех индексированных наборов данных, доступных с помощью OpenSanctions.

Получение работоспособности системы

Проверьте работоспособность системы, чтобы проверить доступность службы.

Получение алгоритмов сопоставления

Список поддерживаемых алгоритмов сопоставления сущностей, используемых системой.

Принудительное обновление индекса

Активируйте операцию повторного индексирования, если авторизована допустимым маркером обновления.

Начало работы

  1. Создайте учетную запись в OpenSanctions.org.
  2. Ключ API
  3. В Power Automate или Power Apps создайте новое подключение с помощью ключа API.
  4. Используйте действия соединителя для поиска, сопоставления или получения сущностей.

Получение учетных данных

Посетите https://www.opensanctions.org/api/ сайт, чтобы запросить ключ API. Вы получите ApiKey значение, которое должно использоваться в заголовке Authorization :

Авторизация: ApiKey YOUR_API_KEY

Известные проблемы и ограничения

  • Структуры реагирования являются динамическими; Используйте "Анализ JSON" в Power Automate для доступа к вложенным значениям.
  • match Конечные search точки могут возвращать большие ответы в зависимости от области набора данных.
  • Для некоторых конечных точек требуется допустимый dataset параметр (например, sanctions).
  • Сортировка по неподдерживаемым полям (например score) может вызвать ошибки.
  • Ограничения скорости API могут применяться в зависимости от плана.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
ключ API securestring Api_key для этого API True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Поиск сущностей в наборе данных

Используйте эту конечную точку для поиска сущностей по имени или ключевому слову в наборе данных. Поддерживает фильтры полей, нечеткое сопоставление и необязательное аспектирование.
Получение каталога наборов данных

Возвращает полный каталог служб, содержащий все доступные и индексированные наборы данных в API OpenSanctions. Полезно для обнаружения имен и метаданных наборов данных.
Получение необработанных инструкций сущностей

Возвращает детализированные данные сущности в виде отдельных инструкций из базы данных OpenSanctions. Каждая инструкция представляет один факт (например, имя, адрес, дата рождения), извлеченный из исходных данных.
Получение поддерживаемых алгоритмов сопоставления

Извлекает список всех поддерживаемых алгоритмов сопоставления и оценки, используемых API для сравнения сущностей и ранжирования результатов.
Получение связанных сущностей по свойству

Возвращает сущности, связанные с данной сущностью через определенное свойство, например владение, семейные связи или идентификаторы. Полезно для подробного изучения связей графа.
Получение сущностей, смежных с сущностью

Возвращает сущности, подключенные к указанной сущности, например связанные люди, компании, идентификаторы или санкции. Полезно для изучения связей графов в наборе данных OpenSanctions.
Получение сущности по идентификатору

Возвращает полную запись для сущности, указанной его идентификатором, включая связанные данные, такие как владение, ассоциации и связанные свойства.
Принудительное восстановление индекса

Активирует ручное перестроение индекса поиска. Требуется допустимый маркер обновления для авторизации. Используйте это для обновления набора данных при изменении данных или структуры.
Проверка готовности индекса поиска

Возвращает состояние индекса поиска, указывающее, готов ли API обрабатывать запросы. Полезно для мониторинга готовности к запуску и развертыванию.
Проверка состояния работоспособности API

Возвращает простой ответ состояния, подтверждающий, что API доступен и работает. Часто используется средствами мониторинга или пробами активности Kubernetes.
Согласование сущностей для набора данных

Предоставляет конечную точку выверки, совместимую с API Google Refine (OpenRefine). Используйте это для массового сопоставления или проверки имен сущностей в наборе данных из внешнего инструмента, например OpenRefine.
Сопоставление сущностей с набором данных

Используйте эту конечную точку для сопоставления людей или компаний с набором данных с использованием нечетких имен, дат рождения и критериев национальности. Возвращает результаты оценки соответствия с пороговым значением достоверности.

Поиск сущностей в наборе данных

Идентификатор операции:
Search_search__dataset__get

Используйте эту конечную точку для поиска сущностей по имени или ключевому слову в наборе данных. Поддерживает фильтры полей, нечеткое сопоставление и необязательное аспектирование.

Параметры

Имя Ключ Обязательно Тип Описание
Целевой набор данных
 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

Устарело. Вместо этого используйте параметр "темы".
Нечеткий поиск
 fuzzy boolean

Включите сопоставление нечеткого текста (приблизительный поиск).
Простой режим
 simple boolean

Упростите результаты, пропуская подробные метаданные.
Поля аспектов
 facets array

Возвращает счетчики аспектов для этих полей.
Оператор фильтра
 filter_op string

Логика для объединения нескольких фильтров (AND/OR).

Возвращаемое значение

SearchResponse
SearchResponse

Получение каталога наборов данных

Идентификатор операции:
Catalog_catalog_get

Возвращает полный каталог служб, содержащий все доступные и индексированные наборы данных в API OpenSanctions. Полезно для обнаружения имен и метаданных наборов данных.

Возвращаемое значение

response
object

Получение необработанных инструкций сущностей

Идентификатор операции:
Statements_statements_get

Возвращает детализированные данные сущности в виде отдельных инструкций из базы данных OpenSanctions. Каждая инструкция представляет один факт (например, имя, адрес, дата рождения), извлеченный из исходных данных.

Параметры

Имя Ключ Обязательно Тип Описание
Имя набора данных
 dataset string

Ограничить результаты операторами из этого набора данных.
Идентификатор сущности
 entity_id string

Возвращаемые инструкции, связанные с этим идентификатором сущности.
Канонический идентификатор
 canonical_id string

Получение инструкций для канонического идентификатора сущности.
Фильтр свойств
 prop string

Фильтрация инструкций по имени свойства.
Значение свойства
 value string

Операторы фильтра, содержащие это значение свойства.
Фильтр схемы
 schema string

Ограничить операторы сущностями заданной схемы.
Порядок сортировки
 sort array

Сортируйте результаты по полю, например timestamp:desc.
Ограничение результатов
 limit integer

Максимальное количество возвращаемых операторов (1–5000).
Смещение результата
 offset integer

Начальное смещение для результатов с разбивкой на страницы.

Возвращаемое значение

StatementResponse
StatementResponse

Получение поддерживаемых алгоритмов сопоставления

Идентификатор операции:
Algorithms_algorithms_get

Извлекает список всех поддерживаемых алгоритмов сопоставления и оценки, используемых API для сравнения сущностей и ранжирования результатов.

Возвращаемое значение

АлгоритмResponse
AlgorithmResponse

Получение связанных сущностей по свойству

Идентификатор операции:
Fetch_Adjacent_by_Property__entities__entity_id__adjacent__property_name__get

Возвращает сущности, связанные с данной сущностью через определенное свойство, например владение, семейные связи или идентификаторы. Полезно для подробного изучения связей графа.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сущности
 entity_id True string

Уникальный идентификатор сущности, связанные с элементами для получения.
Название свойства
 property_name True string

Имя свойства, используемое для получения связанных сущностей.
Порядок сортировки
 sort array

Сортировка связанных сущностей по полю, например score:desc.
Ограничение результатов
 limit integer

Максимальное количество связанных сущностей для возврата (1–500).
Смещение результата
 offset integer

Начальное смещение для связанных результатов с разбивкой на страницы.

Возвращаемое значение

Динамическая структура JSON, отражающая связанные сущности. Каждое свойство может содержать массивы строк или вложенных объектов сущностей.

response
object

Получение сущностей, смежных с сущностью

Идентификатор операции:
Fetch_Adjacent_Entities__entities__entity_id__adjacent_get

Возвращает сущности, подключенные к указанной сущности, например связанные люди, компании, идентификаторы или санкции. Полезно для изучения связей графов в наборе данных OpenSanctions.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сущности
 entity_id True string

Уникальный идентификатор сущности, подключения к которой требуется получить.
Порядок сортировки
 sort array

Сортируйте результаты по полю, например score:desc.
Ограничение результатов
 limit integer

Максимальное количество связанных сущностей для возврата (1–500).
Смещение результата
 offset integer

Начальное смещение для связанных сущностей с разбивкой на страницы.

Возвращаемое значение

response
object

Получение сущности по идентификатору

Идентификатор операции:
Fetch_entity_entities__entity_id__get

Возвращает полную запись для сущности, указанной его идентификатором, включая связанные данные, такие как владение, ассоциации и связанные свойства.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сущности
 entity_id True string

Уникальный идентификатор извлекаемой сущности.
Включение вложенных сущностей
 nested boolean

Включите связанные или связанные сущности в ответ.

Возвращаемое значение

Динамический объект JSON. Разрешает все типы полей без проверки.

response
object

Принудительное восстановление индекса

Идентификатор операции:
Force_update_updatez_post

Активирует ручное перестроение индекса поиска. Требуется допустимый маркер обновления для авторизации. Используйте это для обновления набора данных при изменении данных или структуры.

Параметры

Имя Ключ Обязательно Тип Описание
Обновление маркера
 token string

Маркер API, необходимый для авторизации перестроения индекса.
Режим синхронизации
 sync boolean

Запустите синхронно и дождитесь завершения индекса.

Возвращаемое значение

StatusResponse
StatusResponse

Проверка готовности индекса поиска

Идентификатор операции:
Readyz_readyz_get

Возвращает состояние индекса поиска, указывающее, готов ли API обрабатывать запросы. Полезно для мониторинга готовности к запуску и развертыванию.

Возвращаемое значение

StatusResponse
StatusResponse

Проверка состояния работоспособности API

Идентификатор операции:
Healthz_healthz_get

Возвращает простой ответ состояния, подтверждающий, что API доступен и работает. Часто используется средствами мониторинга или пробами активности Kubernetes.

Возвращаемое значение

StatusResponse
StatusResponse

Согласование сущностей для набора данных

Идентификатор операции:
Reconcile_reconcile__dataset__get

Предоставляет конечную точку выверки, совместимую с API Google Refine (OpenRefine). Используйте это для массового сопоставления или проверки имен сущностей в наборе данных из внешнего инструмента, например OpenRefine.

Параметры

Имя Ключ Обязательно Тип Описание
Целевой набор данных
 dataset True string

Для согласования с набором данных или именем коллекции.

Возвращаемое значение

FreebaseManifest
FreebaseManifest

Сопоставление сущностей с набором данных

Идентификатор операции:
Match_match__dataset__post

Используйте эту конечную точку для сопоставления людей или компаний с набором данных с использованием нечетких имен, дат рождения и критериев национальности. Возвращает результаты оценки соответствия с пороговым значением достоверности.

Параметры

Имя Ключ Обязательно Тип Описание
Имя целевого набора данных
 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.
Исключенные идентификаторы сущностей
 exclude_entity_ids array

Идентификаторы сущностей, которые следует игнорировать во время сопоставления. Используется для фильтрации ложных срабатываний или ранее проверенных сущностей.
Заголовок типа контента
 Content-Type string

Тип контента текста запроса (application/json).
Веса
 weights object
config
 config object

Параметры конфигурации, относящиеся к алгоритму.
queries
 queries True object

Возвращаемое значение

EntityMatchResponse
EntityMatchResponse

Определения

Алгоритм

Имя Путь Тип Описание
имя
 name string

Имя алгоритма сопоставления или оценки.
описание
 description string

Краткое описание того, что делает алгоритм.
features
 features object

Устарело. Вместо него используйте свойство docs.
AlgorithmDocs
 docs AlgorithmDocs

Документация по алгоритму оценки.

AlgorithmDocs

Документация по алгоритму оценки.

Имя Путь Тип Описание
имя
 name string
описание
 description
config
 config object
features
 features object

АлгоритмResponse

Имя Путь Тип Описание
Алгоритмы
 algorithms array of Algorithm
default
 default string
лучший
 best string

EntityMatchResponse

Имя Путь Тип Описание
Ответы
 responses object
Совпадений
 matcher object

Сведения о компанере, который использовался для оценки этого запроса. Вместо этого используйте /algorithms конечную точку.
limit
 limit integer

EntityResponse

Имя Путь Тип Описание
id
 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

Имя Путь Тип Описание
versions
 versions array of string
имя
 name string
identifierSpace
 identifierSpace string
schemaSpace
 schemaSpace string
документация
 documentation string
размер партии
 batchSize integer
FreebaseManifestView
 view FreebaseManifestView
FreebaseManifestPreview
 preview FreebaseManifestPreview
FreebaseManifestSuggest
 suggest FreebaseManifestSuggest
FreebaseManifestExtend
 extend FreebaseManifestExtend
defaultTypes
 defaultTypes array of FreebaseType

FreebaseManifestExtend

Имя Путь Тип Описание
FreebaseManifestExtendProposeProperties
 propose_properties FreebaseManifestExtendProposeProperties
propose_settings
 propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

Имя Путь Тип Описание
имя
 name string
label
 label string
type
 type string
default
 default
help_text
 help_text string
choices
 choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

Имя Путь Тип Описание
id
 id string
имя
 name string

FreebaseManifestExtendProposeProperties

Имя Путь Тип Описание
service_url
 service_url string
service_path
 service_path string

FreebaseManifestPreview

Имя Путь Тип Описание
URL-адрес
 url string
Ширина
 width integer
height
 height integer

FreebaseManifestSuggest

Имя Путь Тип Описание
FreebaseManifestSuggestType
 entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
 type FreebaseManifestSuggestType
FreebaseManifestSuggestType
 property FreebaseManifestSuggestType

FreebaseManifestSuggestType

Имя Путь Тип Описание
service_url
 service_url string
service_path
 service_path string

FreebaseManifestView

Имя Путь Тип Описание
URL-адрес
 url string

FreebaseType

Имя Путь Тип Описание
id
 id string
имя
 name string
описание
 description

SearchResponse

Имя Путь Тип Описание
limit
 limit integer
offset
 offset integer
TotalSpec
 total TotalSpec
results
 results array of EntityResponse
Аспекты
 facets object

Statement

Имя Путь Тип Описание
id
 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
first_seen
 first_seen date-time
last_seen
 last_seen date-time

StatementResponse

Имя Путь Тип Описание
limit
 limit integer
offset
 offset integer
TotalSpec
 total TotalSpec
results
 results array of Statement

StatusResponse

Имя Путь Тип Описание
статус
 status string

TotalSpec

Имя Путь Тип Описание
value
 value integer
отношение
 relation string

объект

Это тип object.