OpenSanctions (Publicador independiente) (versión preliminar)

OpenSanctions API le permite buscar y consultar las sanciones globales y la base de datos de personas expuestas políticamente (PEP). Proporciona puntos de conexión para la coincidencia de entidades, búsqueda de texto, recuperación de entidades y datos granulares de nivel de instrucción. Úselo para comprobar a personas o compañías contra listas de sanciones o explorar el gráfico de entidades OpenSanctions.

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Premium	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes:      - Regiones de Azure Government      - Regiones de Azure China      - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Premium	Todas las regiones de Power Apps excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Premium	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)

Contacto
Nombre	OpenSanctions
URL	https://developments.substack.com
Correo Electrónico	dan.romano@swolcat.com

Metadatos del conector
Publicador	krautrocker
Sitio web	https://www.opensanctions.org/
Directiva de privacidad	https://www.opensanctions.org/docs/privacy/
Categorías	Data

OpenSanctions

Información general

OpenSanctions API proporciona acceso a una base de datos global de personas y empresas de intereses políticos, criminales o económicos. Agrega datos de cientos de listas de sanciones, personas expuestas políticamente (PEP) y listas de seguimiento en todo el mundo.

Puede usar este conector para buscar, buscar y capturar entidades, explorar relaciones y analizar la cobertura del conjunto de datos.

Obtenga más información en OpenSanctions.org.

Publicador - Dan Romano (swolcat)

Prerrequisitos

Necesitará una clave de API de OpenSanctions para usar este conector. Regístrese para obtener una clave gratuita en: https://www.opensanctions.org/api/

Operaciones admitidas

Coincidencia de entidades por conjunto de datos

Coincide con entidades basadas en el nombre y los campos opcionales, como la fecha de nacimiento, la nacionalidad y los identificadores. Este punto de conexión admite la coincidencia aproximada.

Buscar entidades en un conjunto de datos

Buscar entidades mediante una consulta de texto simple. Admite filtros, temas, países y conjuntos de datos para búsquedas refinadas.

Obtención de la entidad por identificador

Recupere un único registro de entidad por su identificador único, incluidos los atributos anidados y relacionados.

Obtención de entidades adyacentes

Devuelve entidades adyacentes a una entidad especificada (por ejemplo, asociados, miembros de la familia o empresas relacionadas).

Obtención de entidades adyacentes por propiedad

Devuelve entidades relacionadas para una propiedad específica (por ejemplo, familyPerson, ownershipOwner, membershipMember).

Obtención del catálogo de conjuntos de datos

Recupere la lista de todos los conjuntos de datos indexados disponibles a través de OpenSanctions.

Obtención del estado del sistema

Realice una comprobación de estado del sistema para comprobar la disponibilidad del servicio.

Obtención de algoritmos coincidentes

Enumere los algoritmos de coincidencia de entidades admitidos que usa el sistema.

Forzar actualización del índice

Desencadene una operación de reindización si está autorizado con un token de actualización válido.

Introducción

1. Cree una cuenta en OpenSanctions.org.
2. Una clave de API
3. En Power Automate o Power Apps, cree una nueva conexión mediante la clave de API.
4. Use las acciones del conector para buscar, buscar, buscar o capturar entidades.

Obtención de credenciales

Visite https://www.opensanctions.org/api/ para solicitar una clave de API. Recibirá un ApiKey valor que se debe usar en el Authorization encabezado :

Autorización: ApiKey YOUR_API_KEY

Problemas conocidos y limitaciones

• Las estructuras de respuesta son dinámicas; use "Analizar JSON" en Power Automate para acceder a valores anidados.
• Los search puntos de conexión y match pueden devolver respuestas grandes en función del ámbito del conjunto de datos.
• Algunos puntos de conexión requieren un parámetro válido dataset (por ejemplo, sanctions).
• La ordenación por campos no admitidos (como score) puede desencadenar errores.
• Los límites de velocidad de API se pueden aplicar en función del plan.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado	Parámetros para crear una conexión.	Todas las regiones	No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Description	Obligatorio
clave_api	securestring	La api_key de esta API	Cierto

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	100	60 segundos

Acciones

Buscar entidades en un conjunto de datos	Use este punto de conexión para buscar entidades por nombre o palabra clave dentro de un conjunto de datos. Admite filtros de campo, coincidencia aproximada y facetas opcionales.
Coincidencia de entidades con un conjunto de datos	Use este punto de conexión para hacer coincidir personas o empresas con un conjunto de datos mediante el nombre aproximado, la fecha de nacimiento y los criterios de nacionalidad. Devuelve resultados de coincidencia puntuados con umbrales de confianza.
Comprobación de la preparación del índice de búsqueda	Devuelve el estado del índice de búsqueda para indicar si la API está lista para controlar las consultas. Útil para supervisar la preparación de inicio e implementación.
Comprobación del estado de la API	Devuelve una respuesta de estado simple que confirma que la API es accesible y operativa. Normalmente se usa mediante herramientas de supervisión o sondeos de ejecución de Kubernetes.
Conciliación de entidades para un conjunto de datos	Proporciona un punto de conexión de conciliación compatible con la API de Google Refine (OpenRefine). Úselo para buscar coincidencias masivas o comprobar nombres de entidad en un conjunto de datos desde una herramienta externa, como OpenRefine.
Forzar regeneración de índices	Desencadena una recompilación manual del índice de búsqueda. Requiere un token de actualización válido para la autorización. Úselo para actualizar el conjunto de datos cuando se produzcan cambios en los datos o la estructura.
Obtención de algoritmos de coincidencia admitidos	Recupera una lista de todos los algoritmos de coincidencia y puntuación admitidos que usa la API para la comparación de entidades y la clasificación de resultados.
Obtención de entidades adyacentes a una entidad	Devuelve entidades conectadas a la entidad especificada, como personas vinculadas, empresas, identificadores o sanciones. Resulta útil para explorar las relaciones de grafos en el conjunto de datos OpenSanctions.
Obtención de entidades relacionadas por propiedad	Devuelve entidades relacionadas con una entidad determinada a través de una propiedad específica, como la propiedad, los vínculos familiares o los identificadores. Resulta útil para explorar las relaciones de grafos con detalle.
Obtención de instrucciones de entidad sin procesar	Devuelve datos de entidad granulares como instrucciones individuales de la base de datos OpenSanctions. Cada instrucción representa un único hecho (por ejemplo, nombre, dirección, fecha de nacimiento) extraído de los datos de origen.
Obtención de la entidad por identificador	Devuelve el registro completo de una entidad especificada por su identificador, incluidos los datos relacionados, como la propiedad, las asociaciones y las propiedades vinculadas.
Obtención del catálogo de conjuntos de datos	Devuelve el catálogo de servicios completo que contiene todos los conjuntos de datos disponibles e indexados en openSanctions API. Resulta útil para detectar los nombres y metadatos del conjunto de datos.

Buscar entidades en un conjunto de datos

Id. de la operación:

Search_search__dataset__get

Use este punto de conexión para buscar entidades por nombre o palabra clave dentro de un conjunto de datos. Admite filtros de campo, coincidencia aproximada y facetas opcionales.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Conjunto de datos de destino	dataset	True	string	Conjunto de datos o colección en el que se va a buscar.
Consulta de búsqueda	q		string	Texto que se va a buscar, como un nombre o una palabra clave.
Filtro de esquema	schema		string	Restrinja los resultados a un esquema específico (por ejemplo, Persona).
Conjuntos de datos incluidos	include_dataset		array	Solo devuelve entidades de estos conjuntos de datos.
Conjuntos de datos excluidos	exclude_dataset		array	Excluya las entidades de estos conjuntos de datos.
Esquemas excluidos	exclude_schema		array	Excluya las entidades de estos tipos de esquema.
Se ha cambiado desde la fecha	changed_since		string	Solo se incluyen entidades actualizadas desde esta fecha ISO.
Filtro de país	countries		array	Filtre por códigos de país (ISO 3166-1 alpha-2).
Filtro de temas	topics		array	Restrinja los resultados a las entidades etiquetadas con temas.
Filtro de conjuntos de datos	datasets		array	Filtre por identificadores de conjunto de datos.
Filtro de campo	filter		array	Use la sintaxis 'field:value' para filtrar campos, por ejemplo, properties.birthDate:1985.
Límite de resultados	limit		integer	Número máximo de resultados que se van a devolver (1–500).
Desplazamiento de resultados	offset		integer	Desplazamiento inicial para los resultados paginados.
Criterio de ordenación	sort		array	Ordene los resultados por campo, por ejemplo, score:desc.
Destino (en desuso)	target		string	Deprecated. Use el parámetro "topics" en su lugar.
Búsqueda aproximada	fuzzy		boolean	Habilite la coincidencia de texto aproximada (búsqueda aproximada).
Modo simple	simple		boolean	Simplifique los resultados omitiendo metadatos detallados.
Campos de faceta	facets		array	Devuelve recuentos de facetas para estos campos.
Operador de filtro	filter_op		string	Lógica para combinar varios filtros (AND/OR).

Devoluciones

SearchResponse

SearchResponse

Coincidencia de entidades con un conjunto de datos

Id. de la operación:

Match_match__dataset__post

Use este punto de conexión para hacer coincidir personas o empresas con un conjunto de datos mediante el nombre aproximado, la fecha de nacimiento y los criterios de nacionalidad. Devuelve resultados de coincidencia puntuados con umbrales de confianza.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre del conjunto de datos de destino	dataset	True	string	Nombre de conjunto de datos o colección en el que se ejecutará la consulta de coincidencia.
Límite de resultados	limit		integer	Número máximo de coincidencias que se van a devolver (de 1 a 500).
Umbral de coincidencia	threshold		double	Puntuación mínima para incluir un resultado (0–1).
Puntuación de corte	cutoff		double	Puntuación mínima aceptable para el mejor corte de coincidencia.
Versión del algoritmo	algorithm		string	Algoritmo de coincidencia que se va a usar, por ejemplo, logic-v1.
Conjuntos de datos incluidos	include_dataset		array	Conjuntos de datos que se van a incluir explícitamente en la coincidencia.
Esquemas excluidos	exclude_schema		array	Esquemas que se excluirán del proceso de coincidencia.
Conjuntos de datos excluidos	exclude_dataset		array	Conjuntos de datos que se excluirán del proceso de coincidencia.
Filtro de temas	topics		array	Restrinja las coincidencias a las entidades etiquetadas con estos temas.
Se ha cambiado desde la fecha	changed_since		string	Solo se han cambiado las entidades desde esta fecha ISO.
Identificadores de entidad excluidos	exclude_entity_ids		array	Identificadores de entidad que se omitirán durante la coincidencia. Use para filtrar falsos positivos o entidades revisadas previamente.
Encabezado de tipo de contenido	Content-Type		string	Tipo de contenido del cuerpo de la solicitud (application/json).
Pesos	weights		object
config	config		object	Parámetros de configuración específicos del algoritmo.
queries	queries	True	object

Devoluciones

EntityMatchResponse

EntityMatchResponse

Comprobación de la preparación del índice de búsqueda

Id. de la operación:

Readyz_readyz_get

Devuelve el estado del índice de búsqueda para indicar si la API está lista para controlar las consultas. Útil para supervisar la preparación de inicio e implementación.

Devoluciones

StatusResponse

StatusResponse

Comprobación del estado de la API

Id. de la operación:

Healthz_healthz_get

Devuelve una respuesta de estado simple que confirma que la API es accesible y operativa. Normalmente se usa mediante herramientas de supervisión o sondeos de ejecución de Kubernetes.

Devoluciones

StatusResponse

StatusResponse

Conciliación de entidades para un conjunto de datos

Id. de la operación:

Reconcile_reconcile__dataset__get

Proporciona un punto de conexión de conciliación compatible con la API de Google Refine (OpenRefine). Úselo para buscar coincidencias masivas o comprobar nombres de entidad en un conjunto de datos desde una herramienta externa, como OpenRefine.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Conjunto de datos de destino	dataset	True	string	Nombre de conjunto de datos o colección con el que se va a conciliar.

Devoluciones

FreebaseManifest

FreebaseManifest

Forzar regeneración de índices

Id. de la operación:

Force_update_updatez_post

Desencadena una recompilación manual del índice de búsqueda. Requiere un token de actualización válido para la autorización. Úselo para actualizar el conjunto de datos cuando se produzcan cambios en los datos o la estructura.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Actualizar token	token		string	Token de API necesario para autorizar la recompilación del índice.
Modo de sincronización	sync		boolean	Ejecute de forma sincrónica y espere a que finalice el índice.

Devoluciones

StatusResponse

StatusResponse

Obtención de algoritmos de coincidencia admitidos

Id. de la operación:

Algorithms_algorithms_get

Recupera una lista de todos los algoritmos de coincidencia y puntuación admitidos que usa la API para la comparación de entidades y la clasificación de resultados.

Devoluciones

AlgorithmResponse

AlgorithmResponse

Obtención de entidades adyacentes a una entidad

Id. de la operación:

Fetch_Adjacent_Entities__entities__entity_id__adjacent_get

Devuelve entidades conectadas a la entidad especificada, como personas vinculadas, empresas, identificadores o sanciones. Resulta útil para explorar las relaciones de grafos en el conjunto de datos OpenSanctions.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de entidad	entity_id	True	string	Identificador único de la entidad cuyas conexiones se van a recuperar.
Criterio de ordenación	sort		array	Ordene los resultados por campo, por ejemplo, score:desc.
Límite de resultados	limit		integer	Número máximo de entidades relacionadas que se van a devolver (de 1 a 500).
Desplazamiento de resultados	offset		integer	Desplazamiento inicial de las entidades relacionadas paginadas.

Devoluciones

response

object

Obtención de entidades relacionadas por propiedad

Id. de la operación:

Fetch_Adjacent_by_Property__entities__entity_id__adjacent__property_name__get

Devuelve entidades relacionadas con una entidad determinada a través de una propiedad específica, como la propiedad, los vínculos familiares o los identificadores. Resulta útil para explorar las relaciones de grafos con detalle.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de entidad	entity_id	True	string	Identificador único de la entidad cuyos elementos relacionados se van a capturar.
Nombre de propiedad	property_name	True	string	Nombre de propiedad usado para capturar entidades relacionadas.
Criterio de ordenación	sort		array	Ordene las entidades relacionadas por campo, por ejemplo, score:desc.
Límite de resultados	limit		integer	Número máximo de entidades relacionadas que se van a devolver (de 1 a 500).
Desplazamiento de resultados	offset		integer	Desplazamiento inicial para los resultados relacionados paginados.

Devoluciones

Entidades relacionadas con la repetición de la estructura JSON dinámica. Cada propiedad puede contener matrices de cadenas o objetos de entidad anidados.

response

object

Obtención de instrucciones de entidad sin procesar

Id. de la operación:

Statements_statements_get

Devuelve datos de entidad granulares como instrucciones individuales de la base de datos OpenSanctions. Cada instrucción representa un único hecho (por ejemplo, nombre, dirección, fecha de nacimiento) extraído de los datos de origen.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre del conjunto de datos	dataset		string	Limite los resultados a las instrucciones de este conjunto de datos.
Id. de entidad	entity_id		string	Devuelve instrucciones vinculadas a este identificador de entidad.
Identificador canónico	canonical_id		string	Captura de instrucciones para el identificador de entidad canónica.
Filtro de propiedades	prop		string	Filtrar instrucciones por nombre de propiedad.
Valor de propiedad	value		string	Instrucciones de filtro que contienen este valor de propiedad.
Filtro de esquema	schema		string	Restrinja las instrucciones a las entidades de un esquema determinado.
Criterio de ordenación	sort		array	Ordene los resultados por campo, por ejemplo, timestamp:desc.
Límite de resultados	limit		integer	Número máximo de instrucciones que se van a devolver (de 1 a 5000).
Desplazamiento de resultados	offset		integer	Desplazamiento inicial de los resultados paginados.

Devoluciones

StatementResponse

StatementResponse

Obtención de la entidad por identificador

Id. de la operación:

Fetch_entity_entities__entity_id__get

Devuelve el registro completo de una entidad especificada por su identificador, incluidos los datos relacionados, como la propiedad, las asociaciones y las propiedades vinculadas.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de entidad	entity_id	True	string	Identificador único de la entidad que se va a recuperar.
Incluir entidades anidadas	nested		boolean	Incluya entidades vinculadas o relacionadas en la respuesta.

Devoluciones

Objeto JSON dinámico. Permite todos los tipos de campo sin validación.

response

object

Obtención del catálogo de conjuntos de datos

Id. de la operación:

Catalog_catalog_get

Devuelve el catálogo de servicios completo que contiene todos los conjuntos de datos disponibles e indexados en openSanctions API. Resulta útil para detectar los nombres y metadatos del conjunto de datos.

Devoluciones

response

object

Definiciones

Algoritmo

Nombre	Ruta de acceso	Tipo	Description
nombre	name	string	Nombre del algoritmo coincidente o de puntuación.
descripción	description	string	Descripción breve de lo que hace el algoritmo.
features	features	object	Deprecated. Utilice la propiedad docs en su lugar.
AlgorithmDocs	docs	AlgorithmDocs	Documentación de un algoritmo de puntuación.

AlgorithmDocs

Documentación de un algoritmo de puntuación.

Nombre	Ruta de acceso	Tipo	Description
nombre	name	string
descripción	description
config	config	object
features	features	object

AlgorithmResponse

Nombre	Ruta de acceso	Tipo	Description
Algoritmos	algorithms	array of Algorithm
predeterminado	default	string
mejor	best	string

EntityMatchResponse

Nombre	Ruta de acceso	Tipo	Description
respuestas	responses	object
buscador de coincidencias	matcher	object	Información sobre el buscador de coincidencias que se usó para puntuar esta solicitud. En su lugar, use /algorithms el punto de conexión en desuso.
limit	limit	integer

EntityResponse

Nombre	Ruta de acceso	Tipo	Description
id	id	string
subtítulo	caption	string
schema	schema	string
Propiedades	properties	object
Conjuntos de datos	datasets	array of string
Referentes	referents	array of string
target	target	boolean
first_seen	first_seen
last_seen	last_seen
last_change	last_change

FreebaseManifest

Nombre	Ruta de acceso	Tipo	Description
versions	versions	array of string
nombre	name	string
identifierSpace	identifierSpace	string
schemaSpace	schemaSpace	string
documentación	documentation	string
batchSize	batchSize	integer
FreebaseManifestView	view	FreebaseManifestView
FreebaseManifestPreview	preview	FreebaseManifestPreview
FreebaseManifestSuggest	suggest	FreebaseManifestSuggest
FreebaseManifestExtend	extend	FreebaseManifestExtend
defaultTypes	defaultTypes	array of FreebaseType

FreebaseManifestExtend

Nombre	Ruta de acceso	Tipo	Description
FreebaseManifestExtendProposeProperties	propose_properties	FreebaseManifestExtendProposeProperties
propose_settings	propose_settings	array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

Nombre	Ruta de acceso	Tipo	Description
nombre	name	string
label	label	string
type	type	string
predeterminado	default
help_text	help_text	string
choices	choices	array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

Nombre	Ruta de acceso	Tipo	Description
id	id	string
nombre	name	string

FreebaseManifestExtendProposeProperties

Nombre	Ruta de acceso	Tipo	Description
service_url	service_url	string
service_path	service_path	string

FreebaseManifestPreview

Nombre	Ruta de acceso	Tipo	Description
URL	url	string
Ancho	width	integer
altura	height	integer

FreebaseManifestSuggest

Nombre	Ruta de acceso	Tipo	Description
FreebaseManifestSuggestType	entity	FreebaseManifestSuggestType
FreebaseManifestSuggestType	type	FreebaseManifestSuggestType
FreebaseManifestSuggestType	property	FreebaseManifestSuggestType

FreebaseManifestSuggestType

Nombre	Ruta de acceso	Tipo	Description
service_url	service_url	string
service_path	service_path	string

FreebaseManifestView

Nombre	Ruta de acceso	Tipo	Description
URL	url	string

FreebaseType

Nombre	Ruta de acceso	Tipo	Description
id	id	string
nombre	name	string
descripción	description

SearchResponse

Nombre	Ruta de acceso	Tipo	Description
limit	limit	integer
offset	offset	integer
TotalSpec	total	TotalSpec
results	results	array of EntityResponse
Facetas	facets	object

Statement

Nombre	Ruta de acceso	Tipo	Description
id	id	string
entity_id	entity_id	string
canonical_id	canonical_id	string
puntal	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

Nombre	Ruta de acceso	Tipo	Description
limit	limit	integer
offset	offset	integer
TotalSpec	total	TotalSpec
results	results	array of Statement

StatusResponse

Nombre	Ruta de acceso	Tipo	Description
estado	status	string

TotalSpec

Nombre	Ruta de acceso	Tipo	Description
value	value	integer
relación	relation	string

objeto

Este es el tipo 'object'.