Flujo común

Los servicios de validación que trabajan por referencia comparten el mismo arranque: obtener el token, disponer de una operación y subir los assets al almacenamiento. Solo después se invoca el servicio concreto con las claves obtenidas.

Esta página reúne ese arranque para no repetirlo en cada servicio. Cada paso enlaza a la página que documenta su contrato.

Diagrama

Los pasos

1. Obtener el token de consumer. Un único token autentica todas las llamadas siguientes y vale una hora. Se emite en nombre de la plataforma y para un consumer concreto. Ver Autenticación.

2. Crear la operación. La operación agrupa los assets de la sesión y les fija una caducidad. Se crea con POST /operation, que devuelve el operationId y su expiresAt. Conviene crearla cuando arranca la captura, no antes, porque el reloj de la caducidad empieza en ese momento. Ver Create Operation.

3. Subir cada asset. Una llamada por captura, declarando el contexto que le corresponde. Cada subida devuelve la fileKey con la que después se referencia el asset. Ver Save Asset, y Storage para los contextos disponibles y el formato de la clave.

4. Invocar el servicio de validación. Se envían las fileKeys tal como las devolvió POST /storage, con el operationId en la cabecera operation-id. La clave no se compone ni se interpreta: añadirle el contexto por tu cuenta lo deja duplicado y el asset no resuelve. Si necesitas recuperar las claves de una operación, están en Get File Keys.

Qué servicios siguen este flujo

Los servicios de validación de identidad admiten por defecto los dos modos de asset, contenido en línea y referencia por clave, y este flujo es el del modo por referencia. Las excepciones son explícitas:

Servicio	Modos admitidos
Form OCR	Solo contenido en línea
Voice Enrollment y Voice Authentication	Solo contenido en línea, sin campo source
Document Validation	Solo referencia, sin campo source

Los servicios exclusivamente en línea no pasan por los pasos 2 y 3: el contenido viaja en la propia llamada y no llevan cabecera operation-id.