API de socios v1 · Borrador, aún no disponible

Monitoreo

Borrador: aún no disponible. Esta página describe el contrato propuesto de la v1 para socios (versión 1.0.0-rc.1). Ningún punto de acceso de esta página está desplegado y todavía no se puede emitir ninguna clave de API.

Un monitor vigila los cambios en entradas, registros y colecciones públicas de listas. Nunca conserva el nombre, la fecha de nacimiento ni el país de una persona que usted verifica, por lo que la nueva verificación de sus propias personas se realiza en su propio sistema.

Por qué un monitor no conserva a una persona

Crown Intelligence nunca almacena el registro de una persona verificada. Un monitor que vigilara a una persona tendría que conservar su nombre, fecha de nacimiento y país para poder comparar con ellos una nueva entrada de lista. Ese es el registro que la regla prohíbe. Por ello, esta versión monitorea únicamente objetivos públicos, y el vínculo con su propia persona permanece en su sistema.

Creación de un monitor

El alcance requerido es monitors:manage. El cuerpo contiene un campo customer_ref (su referencia opaca), hasta 50 targets y los cambios que se desea notificar en notify_on. El esquema es cerrado.

  • entity: un ID de entidad, como crown-e- seguido de un UUID. Usted lo obtiene a partir de un resultado de coincidencia.
  • record: un ID de registro, crown- seguido de un número. Cada coincidencia incluye su record_id.
  • collection: el nombre de una colección, como sanctions o peps.
curl https://api.crownintelligence.net/v1/monitors \
  -H "X-Api-Key: $CI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: mon-setup-0001" \
  -d '{"customer_ref": "cust-0042",
       "targets": [{"type": "entity", "id": "crown-e-6f0c2d1e-8a7b-4c39-9d21-5e4b7a10c3f8"}],
       "notify_on": ["listed", "delisted", "amended", "merged"]}'

Un cuerpo que contenga un nombre, una fecha de nacimiento, un país o un número de identidad se rechaza con 400 personal_data_not_accepted. A continuación se muestra la estructura del error; el texto del mensaje es ilustrativo.

{"type":"https://api.crownintelligence.net/problems/personal_data_not_accepted",
 "title":"Personal data is not accepted","status":400,"code":"personal_data_not_accepted",
 "detail":"A monitor stores a customer reference and public targets only.",
 "messages":{"en":"A monitor stores a customer reference and public targets only.",
   "fr":"Un suivi ne conserve qu'une référence client et des cibles publiques."},
 "request_id":"req_01J9Z7..."}

Los eventos monitor.hit llegan entonces a su webhook cuando un objetivo vigilado se incluye en una lista, se excluye de ella, se modifica o se fusiona. Consulte webhooks.

Nueva verificación de sus propias personas

Cuando llega un evento, usted vuelve a verificar a las personas que conserva por su cuenta. Dos llamadas lo permiten. GET /v1/search con changed_since devuelve solo lo que cambió desde su última ejecución, lo que además reduce el consumo de unidades. Luego, POST /v1/match verifica a cada sujeto con los datos que usted conserva.

curl "https://api.crownintelligence.net/v1/search?changed_since=2026-10-12T00:00:00Z&collection=sanctions&limit=50" \
  -H "X-Api-Key: $CI_API_KEY"
// Runs in YOUR system when a monitor.hit or list.updated event arrives.
// Your subject data never goes to Crown Intelligence except as the query of a match request.
async function rescreenSubjects(subjects, changedSince) {
  // 1. Ask what changed, scoped to the collections you watch.
  const url = "https://api.crownintelligence.net/v1/search?changed_since=" +
    encodeURIComponent(changedSince) + "&collection=sanctions&limit=50";
  const changed = await (await fetch(url, { headers: { "X-Api-Key": process.env.CI_API_KEY } })).json();

  // 2. Re-screen only your own subjects, with your own copy of their details.
  for (const subject of subjects) {
    const body = { queries: [{ query_ref: subject.ref, entity_type: "Person",
                              name: subject.name, dob: subject.dob, country: subject.country }] };
    const res = await fetch("https://api.crownintelligence.net/v1/match", {
      method: "POST",
      headers: { "X-Api-Key": process.env.CI_API_KEY, "Content-Type": "application/json",
                 "Idempotency-Key": "rescreen-" + subject.ref + "-" + changedSince },
      body: JSON.stringify(body)
    });
    // 3. Handle each status as on the matching page: only no_hit_searched is a negative.
  }
  return changed;
}

Crown Intelligence solo ve la consulta de cada coincidencia. Conserva un resumen con clave de esa consulta y no el nombre.

Puntos pendientes

  • Vigilar una entrada pública le indica a Crown Intelligence que usted tiene interés en ella. No revela su sujeto a nadie. Los términos para socios deberían indicarlo.
  • Un socio que conserva a sus sujetos en un almacén que llama a Crown Intelligence tiene respecto de ese almacén las mismas obligaciones que Crown Intelligence tiene con el suyo. Los términos para socios deberían indicarlo.
  • Los monitores que conserven sujetos con nombre requerirían modificar la decisión que los prohíbe, un almacén independiente y una regla de retención. Nada de esto forma parte de la v1.

Este diseño sigue la opción A de la sección 9 del borrador del contrato. La aprobación del responsable está pendiente.