Flujo de verificación de identidad
El proceso de verificación de identidad involucra tres servicios distintos: la Adamo ID API (API principal), el Servicio GPU (captura y análisis de documentos en tiempo real) y el Queue Service (procesamiento asíncrono con respuesta por Socket.io).
Flujo combinado: si este paso forma parte de un recorrido con múltiples verificaciones, los pasos
GET /flow-runs/verifyyPOST /flow-runs/startse ejecutan una sola vez al inicio. Consulta Flujos con múltiples verificaciones.
El
req_idde sesión GPU se crea en este paso y se reutiliza en el flujo de prueba de vida si se ejecutan en el mismo recorrido.
Descripción de cada paso
| Paso | Servicio | Endpoint | Descripción |
|---|---|---|---|
| 1 | Adamo ID API | GET /flow-runs/verify/{invitationToken} | Valida el token de invitación y obtiene la configuración del flujo |
| 2 | Adamo ID API | POST /flow-runs/start | Inicia la sesión y obtiene el authToken para los pasos siguientes |
| 3 | GPU | POST /req/new | Crea la sesión GPU y obtiene el req_id |
| 4 | GPU | WS /ws-id-live | WebSocket de guía en tiempo real para encuadrar el frente del documento |
| 5 | GPU | POST /upload-id-still | Sube el frame capturado del frente; devuelve URLs de imágenes procesadas |
| 6 | Queue | POST /identity/analyze-and-extract-document-data | Inicia extracción OCR asíncrona; resultado llega por Socket.io |
| 7 (si aplica) | GPU | WS /ws-id-back-live | WebSocket de guía para el dorso (solo documentos con reverso) |
| 8 (si aplica) | GPU | POST /upload-id-back-still | Sube el frame del dorso; devuelve used_id_back_path |
| 9 (si aplica) | Queue | POST /identity/analyze-document-authenticity | Inicia verificación de autenticidad asíncrona |
Los pasos 7–9 solo aplican para documentos con dorso: cédulas, licencias de conducir, permisos de conducción y cédulas de extranjería. Los pasaportes solo requieren los pasos 1–6.

