La API de coincidencias

Verifique personas, empresas, organizaciones y embarcaciones frente a nuestras colecciones, con una puntuación y una explicación para cada resultado.

La API de coincidencias compara las partes que usted conoce (clientes, proveedores, contrapartes, embarcaciones) con cada registro de una colección y devuelve los más cercanos, con una puntuación y una explicación. Para comenzar:

Inicio rápido: una primera solicitud en cURL, Python o Node.
La solicitud: colecciones, filtros, esquema y propiedades.
La respuesta: puntuaciones, explicaciones y campos de resultados.
La API de entidades: el registro completo detrás de un resultado.

Cómo crear un proceso de verificación con la API de coincidencias

La verificación no es una búsqueda de texto. Un nombre por sí solo coincide con muchas personas; el motor de coincidencias pondera el nombre junto con la fecha de nacimiento, la nacionalidad o el país, el número IMO y el tipo de entidad, de modo que la parte que usted busca sube en la lista y los homónimos quedan atrás.

Paso 1: describa sus partes en nuestros términos

Asigne sus propias columnas a una consulta: el nombre completo (y cualquier otro nombre) a name, la fecha de nacimiento a birthDate, la nacionalidad, la residencia o el país de registro a nationality o country como códigos de dos letras, y el número IMO a imoNumber. Elija el esquema según el tipo de cliente.

{
  "schema": "Person",
  "properties": {
    "name": ["Maria Example", "Maria Ejemplo"],
    "birthDate": ["1971-05"],
    "nationality": ["ve", "es"]
  }
}

Cada propiedad es una lista, por lo que debe enviar todos los nombres y nacionalidades que tenga. Convierta los nombres de países a códigos ISO antes de enviarlos; el motor de coincidencias compara únicamente códigos.

Paso 2: elija dónde buscar

Comience con default, que contiene todas las listas que publicamos. Si sus obligaciones son más acotadas, use sanctions, peps, crime o maritime, o mantenga default y filtre con topics y include_dataset. Consulte Alcance.

Paso 3: envíe lotes

Envíe hasta 20 partes por solicitud, cada una con su propia clave, y almacene la hora de checked_at, las puntuaciones y las explicaciones junto con sus registros. El inicio rápido incluye código funcional.

Cómo interpretar los resultados

Cada resultado es el registro de un registro público. topics y list_type indican qué tipo de lista es, programme nombra el programa o la base legal, y datasets nombra el registro. Obtenga el registro desde la API de entidades para ver cada inclusión en listas y cada otro registro que nombre a la misma parte, o abra su página desde url.

Cómo reducir las alertas falsas

Envíe fechas de nacimiento, nacionalidades y números IMO siempre que los tenga.
Verifique solo las listas que necesita, usando la colección y los filtros.
Defina el umbral según su apetito de riesgo y revise todo lo que lo supere; consulte Ajuste.
Registre por qué se descartó cada alerta, para que el mismo registro no requiera una nueva revisión la próxima vez.

Conciliación para OpenRefine

El mismo motor de coincidencias está disponible como servicio de conciliación: agregue https://api.crownintelligence.net/api/reconcile/default (o cualquier colección) en OpenRefine para encontrar coincidencias con una columna de una hoja de cálculo, con hasta 20 consultas por lote. Consulte la referencia.

Ejecutar el motor de coincidencias por su cuenta

Por definir: Si ofrecemos una implementación local o autoalojada del servicio de coincidencias y bajo qué condiciones.

Última actualización 2026-10-03