Preguntas frecuentes de la API

Use POST /api/match para decidir si una parte figura en una lista: puntúa a cada candidato según nombre, fecha de nacimiento, país, número IMO y tipo, y explica la puntuación. Use GET /api/search para consultas e interfaces: muestra los registros que contienen sus palabras, sin puntuación.

Para mantenerlos rápidos y ligeros. Obtenga /api/entity/<id> para un registro con sus inclusiones en listas y los demás registros que nombran a la misma parte, o la entidad combinada para ver la vista unificada.

Hasta 20 consultas por solicitud de match o reconcile, cada una con hasta 50 resultados. Las consultas que excedan las 20 se ignoran.

Una consulta necesita al menos un nombre o un número IMO. El campo error indica qué faltaba, y las demás consultas del lote se ejecutan igualmente.

La entrada de cada registro es un registro independiente, por lo que una persona incluida en cinco listas puede generar cinco resultados. Los registros que hemos vinculado comparten merged_entity.

Los resultados reflejan los registros cargados en el momento de la solicitud. Algunas respuestas de solo lectura (search, facets, sources, programmes, countries) se almacenan en caché hasta 10 minutos; los resultados de match no se almacenan en caché.

Hoy no se aplica ninguna cuota. El servicio puede aplicar un límite de solicitudes por dirección y, cuando lo hace, responde 429 con Retry-After; consulte Límites de solicitudes.

• Agrupe hasta 20 partes por solicitud de match.
• No vuelva a verificar partes sin cambios frente a una colección sin cambios: compare primero el version de la colección desde /api/catalog.
• Aplique una espera progresiva ante 429 y 503 y reintente más tarde, en lugar de hacerlo de inmediato.
• Para carteras grandes, considere los archivos masivos.