Guía de Integración Asíncrona

La arquitectura de Blacktrust opera de forma asíncrona debido a la complejidad en el procesamiento de información externa como buró de crédito, antecedentes penales y validación de identidad.

Los recursos atómicos vinculados a este flujo se denominan Processes. El siguiente diagrama ilustra el flujo óptimo para el registro de candidatos y consulta de resultados:

Flujo de Trabajo (Workflow)

Explicación Paso a Paso

1. Autenticación (Auth): Antes de consumir cualquier endpoint, debes obtener un Token JWT Bearer usando POST /signin. Todos los requests posteriores requieren el header Authorization: Bearer {accessToken}.
2. Registro (Registration): Envías un POST /candidate-requests especificando el packageId.
3. Validación Inmediata: La API Universal valida tus parámetros mediante el motor de validación.
4. Respuesta 202 Accepted: Si es válido, el sistema no bloquea la conexión esperando el scraper; responde un uuid inmediatamente.
5. Worker Processing: Nuestros Processes se ejecutan en segundo plano con alta concurrencia.
6. Polleo: Puedes consultar el estatus usando el uuid vía GET /candidate-requests/{uuid} para obtener el Resumen de la Solicitud.
7. Webhooks: (Recomendado) Puedes configurar un webhook URL para recibir un evento POST inmediato cuando se detecta el cambio de estatus a Completed.