Partilhar via

OpenSanctions (Editora Independente) (Pré-visualização)

A API OpenSanctions permite-lhe pesquisar e consultar a base de dados global de sanções e pessoas politicamente expostas (PEP). Fornece endpoints para correspondência de entidades, pesquisa de texto, recuperação de entidades e dados granulares ao nível da instrução. Utilize-o para verificar pessoas ou empresas contra listas de sanções ou explorar o gráfico de entidades OpenSanctions.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome OpenSanctions
URL https://developments.substack.com
Email dan.romano@swolcat.com
Metadados do conector
Editora Krautrocker
Sítio Web https://www.opensanctions.org/
Política de privacidade https://www.opensanctions.org/docs/privacy/
Categorias Data

OpenSanctions

Visão geral

A API OpenSanctions fornece acesso a uma base de dados global de pessoas e empresas de interesse político, criminal ou económico. Agrega dados de centenas de listas de sanções, pessoas politicamente expostas (PEPs) e listas de vigilância em todo o mundo.

Pode usar este conector para emparelar, pesquisar e obter unidades, explorar relações e analisar a cobertura de conjuntos de dados.

Saiba mais em OpenSanctions.org.

Editora - Dan Romano (swolcat)

Pré-requisitos

Vai precisar de uma chave API da OpenSanctions para usar este conector. Registe-se para receber uma chave gratuita em: https://www.opensanctions.org/api/

Operações suportadas

Corresponder entidades por conjunto de dados

Corresponde entidades com base no nome e em campos opcionais como data de nascimento, nacionalidade e identificadores. Este endpoint suporta correspondência fuzzy.

Entidades de pesquisa num conjunto de dados

Pesquise entidades usando uma consulta de texto simples. Suporta filtros, temas, países e conjuntos de dados para pesquisas refinadas.

Obter a entidade por ID

Recuperar um registo de entidade única pelo seu identificador único, incluindo atributos aninhados e relacionados.

Obter entidades adjacentes

Devolve entidades adjacentes a uma entidade específica (por exemplo, associados, familiares ou empresas relacionadas).

Obter entidades adjacentes por propriedade

Declarar entidades relacionadas com uma propriedade específica (por exemplo, famíliaPessoa, proprietário, membro).

Obtenha catálogo de conjuntos de dados

Recupere a lista de todos os conjuntos de dados indexados disponíveis através do OpenSanctions.

Obtenha saúde do sistema

Realize uma verificação do estado do sistema para verificar a disponibilidade do serviço.

Obtenha algoritmos de correspondência

Lista suportava algoritmos de correspondência de entidades usados pelo sistema.

Atualização do índice de força

Acionar uma operação de reindexação se autorizado com um token de atualização válido.

Introdução

  1. Crie uma conta no OpenSanctions.org.
  2. Uma chave API
  3. No Power Automate ou Power Apps, crie uma nova ligação usando a sua chave API.
  4. Use as ações do conector para procurar, comparar ou buscar entidades.

Obtenção de credenciais

Visite https://www.opensanctions.org/api/ para solicitar uma chave API. Receberá um ApiKey valor que deve ser usado no Authorization cabeçalho:

Autorização: ApiKey YOUR_API_KEY

Problemas conhecidos e limitações

  • As estruturas de resposta são dinâmicas; usar "Parse JSON" no Power Automate para aceder a valores aninhados.
  • Os search endpoints e match podem devolver respostas elevadas dependendo do âmbito do conjunto de dados.
  • Alguns extremos requerem um parâmetro válido dataset (por exemplo, sanctions).
  • Ordenar por campos não suportados (como score) pode desencadear erros.
  • Podem aplicar-se limites de taxa de API dependendo do seu plano.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
chave_de_api securestring O api_key para esta api Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Comparar entidades com um conjunto de dados

Use este endpoint para comparar pessoas ou empresas com um conjunto de dados usando nome, data de nascimento e critérios de nacionalidade difusos. Resultados de correspondência pontuados com limiares de confiança.
Entidades de pesquisa num conjunto de dados

Use este endpoint para pesquisar entidades por nome ou palavra-chave dentro de um conjunto de dados. Suporta filtros de campo, correspondência difusa e facetamento opcional.
Obtenha algoritmos de correspondência suportados

Recupera uma lista de todos os algoritmos de correspondência e pontuação suportados usados pela API para comparação de entidades e classificação de resultados.
Obtenha catálogo de conjuntos de dados

Devolve o catálogo completo de serviços que contém todos os conjuntos de dados disponíveis e indexados na API OpenSanctions. Útil para descobrir nomes de conjuntos de dados e metadados.
Obtenha entidades adjacentes a uma entidade

Devolve entidades ligadas à entidade especificada, como pessoas, empresas, identificadores ou sanções ligadas. Útil para explorar relações de grafos no conjunto de dados OpenSanctions.
Obtenha extratos brutos de entidade

Devolve dados granulares de entidades como extratos individuais da base de dados OpenSanctions. Cada afirmação representa um único facto (por exemplo, nome, morada, data de nascimento) extraído dos dados de origem.
Obter a entidade por ID

Devolve o registo completo de uma entidade especificada pelo seu ID, incluindo dados relacionados como propriedade, associações e propriedades associadas.
Obter entidades relacionadas por propriedade

Devolve entidades relacionadas com uma determinada entidade através de uma propriedade específica, como propriedade, laços familiares ou identificadores. Útil para explorar relações de grafos em detalhe.
Reconciliar entidades para um conjunto de dados

Fornece um endpoint de reconciliação compatível com a API Google Refine (OpenRefine). Use isto para comparar ou verificar nomes de entidades com um conjunto de dados de uma ferramenta externa como o OpenRefine.
Regeneração por índice de força

Desencadeia uma reconstrução manual do índice de pesquisa. Requer um token de atualização válido para autorização. Use isto para atualizar o conjunto de dados quando ocorrerem alterações nos dados ou na estrutura.
Verificar o estado de saúde da API

Devolve uma resposta simples de estado confirmando que a API é acessível e operacional. Comumente usado por ferramentas de monitorização ou sondas de vivacidade Kubernetes.
Verifique a prontidão do índice de pesquisa

Devolve o estado do índice de pesquisa para indicar se a API está pronta para lidar com consultas. Útil para monitorizar a prontidão de arranque e implementação.

Comparar entidades com um conjunto de dados

ID da Operação:
Match_match__dataset__post

Use este endpoint para comparar pessoas ou empresas com um conjunto de dados usando nome, data de nascimento e critérios de nacionalidade difusos. Resultados de correspondência pontuados com limiares de confiança.

Parâmetros

Name Chave Necessário Tipo Description
Nome do conjunto de dados alvo
 dataset True string

Conjunto de dados ou nome da coleção para executar a consulta de correspondência.
Limite de resultados
 limit integer

Número máximo de partidas a regressar (1–500).
Limiar de correspondência
 threshold double

Pontuação mínima para incluir um resultado (0–1).
Pontuação de corte
 cutoff double

Pontuação mínima aceitável para o corte do melhor match.
Versão do algoritmo
 algorithm string

Algoritmo de correspondência para usar, por exemplo, logic-v1.
Conjuntos de dados incluídos
 include_dataset array

Conjuntos de dados a incluir explicitamente na correspondência.
Esquemas excluídos
 exclude_schema array

Esquemas a excluir do processo de correspondência.
Conjuntos de dados excluídos
 exclude_dataset array

Conjuntos de dados a excluir do processo de correspondência.
Tópicos filtrar
 topics array

Restringa correspondências a entidades identificadas com estes tópicos.
Alterado desde a data
 changed_since string

Inclui apenas entidades alteradas desde esta data ISO.
IDs de entidades excluídas
 exclude_entity_ids array

IDs de entidade a ignorar durante o emparelhamento. Use para filtrar falsos positivos ou entidades previamente revistas.
Cabeçalho do tipo de conteúdo
 Content-Type string

Tipo de conteúdo do corpo do pedido (application/json).
Pesos
 weights object
Configurações
 config object

Parâmetros de configuração específicos de algoritmo.
queries
 queries True object

Devoluções

EntityMatchResponse
EntityMatchResponse

Entidades de pesquisa num conjunto de dados

ID da Operação:
Search_search__dataset__get

Use este endpoint para pesquisar entidades por nome ou palavra-chave dentro de um conjunto de dados. Suporta filtros de campo, correspondência difusa e facetamento opcional.

Parâmetros

Name Chave Necessário Tipo Description
Conjunto de dados alvo
 dataset True string

Conjunto de dados ou coleção para pesquisar dentro.
Consulta de pesquisa
 q string

Texto a procurar, como um nome ou palavra-chave.
Filtro de esquema
 schema string

Restringa os resultados a um esquema específico (por exemplo, Pessoa).
Conjuntos de dados incluídos
 include_dataset array

Só devolve entidades desses conjuntos de dados.
Conjuntos de dados excluídos
 exclude_dataset array

Exclua entidades destes conjuntos de dados.
Esquemas excluídos
 exclude_schema array

Exclua entidades destes tipos de esquema.
Alterado desde a data
 changed_since string

Inclui apenas entidades atualizadas desde esta data ISO.
Filtro de país
 countries array

Filtrar por códigos de país (ISO 3166-1 alpha-2).
Tópicos filtrar
 topics array

Restringa os resultados a entidades marcadas com tópicos.
Filtro de conjuntos de dados
 datasets array

Filtrar por identificadores de conjunto de dados.
Filtro de campo
 filter array

Use a sintaxe 'field:value' para filtrar campos, por exemplo, properties.birthDate:1985.
Limite de resultados
 limit integer

Número máximo de resultados a devolver (1–500).
Compensação de resultados
 offset integer

Deslocamento inicial para resultados paginados.
Ordem de classificação
 sort array

Ordenar os resultados por campo, por exemplo, pontuação:desc.
Target (obsoleto)
 target string

Deprecated. Usa o parâmetro 'tópicos' em vez disso.
Pesquisa aproximada
 fuzzy boolean

Ativar correspondência de texto desfocado (pesquisa aproximada).
Modo simples
 simple boolean

Simplifique os resultados saltando metadados detalhados.
Campos de facetas
 facets array

Devolva as contagens de facetas para estes campos.
Operador de filtro
 filter_op string

Lógica para combinar múltiplos filtros (AND/OR).

Devoluções

SearchResponse
SearchResponse

Obtenha algoritmos de correspondência suportados

ID da Operação:
Algorithms_algorithms_get

Recupera uma lista de todos os algoritmos de correspondência e pontuação suportados usados pela API para comparação de entidades e classificação de resultados.

Devoluções

AlgorithmResponse
AlgorithmResponse

Obtenha catálogo de conjuntos de dados

ID da Operação:
Catalog_catalog_get

Devolve o catálogo completo de serviços que contém todos os conjuntos de dados disponíveis e indexados na API OpenSanctions. Útil para descobrir nomes de conjuntos de dados e metadados.

Devoluções

response
object

Obtenha entidades adjacentes a uma entidade

ID da Operação:
Fetch_Adjacent_Entities__entities__entity_id__adjacent_get

Devolve entidades ligadas à entidade especificada, como pessoas, empresas, identificadores ou sanções ligadas. Útil para explorar relações de grafos no conjunto de dados OpenSanctions.

Parâmetros

Name Chave Necessário Tipo Description
ID da Entidade
 entity_id True string

ID único da entidade cujas ligações devem recuperar.
Ordem de classificação
 sort array

Ordenar os resultados por campo, por exemplo, pontuação:desc.
Limite de resultados
 limit integer

Número máximo de entidades relacionadas a regressar (1–500).
Compensação de resultados
 offset integer

Deslocamento inicial para entidades relacionadas paginadas.

Devoluções

response
object

Obtenha extratos brutos de entidade

ID da Operação:
Statements_statements_get

Devolve dados granulares de entidades como extratos individuais da base de dados OpenSanctions. Cada afirmação representa um único facto (por exemplo, nome, morada, data de nascimento) extraído dos dados de origem.

Parâmetros

Name Chave Necessário Tipo Description
Nome do conjunto de dados
 dataset string

Limite os resultados a afirmações deste conjunto de dados.
ID da Entidade
 entity_id string

Extratos de retorno ligados a este ID da entidade.
ID canónico
 canonical_id string

Fetch instruções para o ID da entidade canónica.
Filtro de propriedade
 prop string

Filtrar as instruções por nome da propriedade.
Valor do imóvel
 value string

Instruções de filtro que contêm este valor de propriedade.
Filtro de esquema
 schema string

Restringa as instruções a entidades de um dado esquema.
Ordem de classificação
 sort array

Ordenar os resultados por campo, por exemplo, timestamp:desc.
Limite de resultados
 limit integer

Número máximo de extratos a devolver (1–5000).
Compensação de resultados
 offset integer

Deslocamento inicial para resultados paginados.

Devoluções

StatementResponse
StatementResponse

Obter a entidade por ID

ID da Operação:
Fetch_entity_entities__entity_id__get

Devolve o registo completo de uma entidade especificada pelo seu ID, incluindo dados relacionados como propriedade, associações e propriedades associadas.

Parâmetros

Name Chave Necessário Tipo Description
ID da Entidade
 entity_id True string

ID único da entidade a recuperar.
Incluir entidades aninhadas
 nested boolean

Inclua entidades ligadas ou relacionadas na resposta.

Devoluções

Objeto JSON dinâmico. Permite todos os tipos de campo sem validação.

response
object

Obter entidades relacionadas por propriedade

ID da Operação:
Fetch_Adjacent_by_Property__entities__entity_id__adjacent__property_name__get

Devolve entidades relacionadas com uma determinada entidade através de uma propriedade específica, como propriedade, laços familiares ou identificadores. Útil para explorar relações de grafos em detalhe.

Parâmetros

Name Chave Necessário Tipo Description
ID da Entidade
 entity_id True string

ID único da entidade cujos itens relacionados devem buscar.
Nome da propriedade
 property_name True string

Nome da propriedade usado para obter entidades relacionadas.
Ordem de classificação
 sort array

Ordenar entidades relacionadas por campo, por exemplo, pontuação:desc.
Limite de resultados
 limit integer

Número máximo de entidades relacionadas a regressar (1–500).
Compensação de resultados
 offset integer

Deslocamento inicial para resultados relacionados com paginados.

Devoluções

Estrutura dinâmica JSON que rerepresenta entidades relacionadas. Cada propriedade pode conter arrays de cadeias ou objetos entidade aninhados.

response
object

Reconciliar entidades para um conjunto de dados

ID da Operação:
Reconcile_reconcile__dataset__get

Fornece um endpoint de reconciliação compatível com a API Google Refine (OpenRefine). Use isto para comparar ou verificar nomes de entidades com um conjunto de dados de uma ferramenta externa como o OpenRefine.

Parâmetros

Name Chave Necessário Tipo Description
Conjunto de dados alvo
 dataset True string

Nome do conjunto de dados ou da coleção para reconciliar.

Devoluções

FreebaseManifest
FreebaseManifest

Regeneração por índice de força

ID da Operação:
Force_update_updatez_post

Desencadeia uma reconstrução manual do índice de pesquisa. Requer um token de atualização válido para autorização. Use isto para atualizar o conjunto de dados quando ocorrerem alterações nos dados ou na estrutura.

Parâmetros

Name Chave Necessário Tipo Description
Token de atualização
 token string

Token API necessário para autorizar a reconstrução do índice.
Modo de sincronização
 sync boolean

Executa de forma síncrona e aguarda a conclusão do índice.

Devoluções

StatusResponse
StatusResponse

Verificar o estado de saúde da API

ID da Operação:
Healthz_healthz_get

Devolve uma resposta simples de estado confirmando que a API é acessível e operacional. Comumente usado por ferramentas de monitorização ou sondas de vivacidade Kubernetes.

Devoluções

StatusResponse
StatusResponse

Verifique a prontidão do índice de pesquisa

ID da Operação:
Readyz_readyz_get

Devolve o estado do índice de pesquisa para indicar se a API está pronta para lidar com consultas. Útil para monitorizar a prontidão de arranque e implementação.

Devoluções

StatusResponse
StatusResponse

Definições

Algorithm

Name Caminho Tipo Description
nome
 name string

Nome do algoritmo de correspondência ou pontuação.
descrição
 description string

Breve descrição do que o algoritmo faz.
features
 features object

Deprecated. Use a docs propriedade em vez disso.
AlgorithmDocs
 docs AlgorithmDocs

Documentação para um algoritmo de pontuação.

AlgorithmDocs

Documentação para um algoritmo de pontuação.

Name Caminho Tipo Description
nome
 name string
descrição
 description
Configurações
 config object
features
 features object

AlgorithmResponse

Name Caminho Tipo Description
Algoritmos
 algorithms array of Algorithm
predefinição
 default string
Melhores
 best string

EntityMatchResponse

Name Caminho Tipo Description
Respostas
 responses object
Matcher
 matcher object

Informação sobre o matcher que foi usado para pontuar este pedido. Obsoleto, use /algorithms o endpoint em vez disso.
limit
 limit integer

EntityResponse

Name Caminho Tipo Description
id
 id string
legenda
 caption string
esquema
 schema string
propriedades
 properties object
conjuntos de dados
 datasets array of string
Referências
 referents array of string
destino
 target boolean
first_seen
 first_seen
last_seen
 last_seen
last_change
 last_change

FreebaseManifest

Name Caminho Tipo Description
versions
 versions array of string
nome
 name string
identifierSpace
 identifierSpace string
schemaSpace
 schemaSpace string
documentação
 documentation string
tamanho de batch
 batchSize integer
FreebaseManifestView
 view FreebaseManifestView
FreebaseManifestPreview
 preview FreebaseManifestPreview
FreebaseManifestSuggest
 suggest FreebaseManifestSuggest
FreebaseManifestExtend
 extend FreebaseManifestExtend
defaultTypes
 defaultTypes array of FreebaseType

FreebaseManifestExtend

Name Caminho Tipo Description
FreebaseManifestExtendProposeProperties
 propose_properties FreebaseManifestExtendProposeProperties
propose_settings
 propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

Name Caminho Tipo Description
nome
 name string
etiqueta
 label string
tipo
 type string
predefinição
 default
help_text
 help_text string
choices
 choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

Name Caminho Tipo Description
id
 id string
nome
 name string

FreebaseManifestExtendProposeProperties

Name Caminho Tipo Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestPreview

Name Caminho Tipo Description
URL
 url string
Largura
 width integer
altura
 height integer

FreebaseManifestSuggest

Name Caminho Tipo Description
FreebaseManifestSuggestType
 entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
 type FreebaseManifestSuggestType
FreebaseManifestSuggestType
 property FreebaseManifestSuggestType

FreebaseManifestSuggestType

Name Caminho Tipo Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestView

Name Caminho Tipo Description
URL
 url string

FreebaseType

Name Caminho Tipo Description
id
 id string
nome
 name string
descrição
 description

SearchResponse

Name Caminho Tipo Description
limit
 limit integer
offset
 offset integer
TotalSpec
 total TotalSpec
results
 results array of EntityResponse
Facetas
 facets object

Statement

Name Caminho Tipo Description
id
 id string
entity_id
 entity_id string
canonical_id
 canonical_id string
Prop
 prop string
prop_type
 prop_type string
esquema
 schema string
valor
 value string
original_value
 original_value
conjunto de dados
 dataset string
idioma
 lang
first_seen
 first_seen date-time
last_seen
 last_seen date-time

StatementResponse

Name Caminho Tipo Description
limit
 limit integer
offset
 offset integer
TotalSpec
 total TotalSpec
results
 results array of Statement

StatusResponse

Name Caminho Tipo Description
estado
 status string

TotalSpec

Name Caminho Tipo Description
valor
 value integer
relação
 relation string

objecto

Este é o tipo 'objeto'.