Saltar al contenido principal

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 autenticarte con el método definido en tu contrato: una API Key (header x-api-key) o usuario y contraseña (POST /signin y header Authorization: Bearer). Son métodos alternativos; consulta Autenticación para saber cuál aplica en tu caso.
  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.