Storage
El almacenamiento guarda las capturas de una operación antes de validarlas. Cada asset se almacena una vez, queda asociado a un contexto dentro de la operación, y a partir de ese momento se referencia por su clave en los servicios de validación sin volver a transportar el binario. El recorrido completo, desde el token hasta la llamada de validación, está en Flujo común.
Modos de asset
Los servicios de validación reciben los assets de dos formas, con la misma estructura de petición. El modo lo declara el campo source:
Valor de source
Contenido de los huecos de asset
FILE
Contenido de la captura, codificado en Base64.
FILE_KEY
Clave de un asset ya almacenado.
source es único por petición, no por asset: una petición no puede combinar contenido en línea y referencias. Cuando la petición referencia algún asset por clave, la cabecera operation-id es obligatoria y declara la operación a la que pertenecen todas las claves.
Contextos de asset
El contexto identifica qué captura es el asset y determina en qué huecos de qué servicios puede usarse. Cada servicio declara, en la descripción de sus parámetros, el contexto que admite en cada hueco.
Contexto
Contenido
Formato de asset.file
TOKEN_FRONT_DOCUMENT
Token RAW del anverso del documento de identidad.
Token del buffer generado por el SDK de captura, en Base64.
TOKEN_BACK_DOCUMENT
Token RAW del reverso del documento de identidad.
Token del buffer generado por el SDK de captura, en Base64.
TOKEN_FACE_IMAGE
Rostro recortado del documento de identidad.
Token del buffer generado por el SDK de captura, en Base64.
TOKEN_BEST_IMAGE
Mejor imagen de la captura de selfie.
Token del buffer generado por el SDK de captura, en Base64.
TOKEN_BIN_IAD
Binario de la captura de detección de ataques de inyección.
Binario en Base64.
RAW_IMAGE
Imagen de rostro en abierto, sin tokenizar.
JPEG o PNG en abierto, en Base64.
TOKEN_RAW_IMAGE
Token de una imagen de rostro subida en abierto.
No se admite en la subida: se obtiene subiendo RAW_IMAGE.
El par (operación, contexto) identifica exactamente un asset: una segunda subida del mismo contexto en la misma operación se responde 409. Si hay que repetir una captura ya almacenada, se crea una operación nueva.
RAW_IMAGE nombra el contenido tal como llega, no como queda almacenado, y es el único contexto con esa asimetría. La imagen en abierto se tokeniza al recibirla y no se almacena: la operación conserva el token, y la clave que devuelve Save Asset lleva el contexto TOKEN_RAW_IMAGE, que es el que se referencia después y la única forma en que se puede leer de vuelta. Declarar TOKEN_RAW_IMAGE en la subida se rechaza con 400. Está previsto para el rostro que entrega un registro civil, y se referencia como sourceImage en Facial Matching.
Formato de la clave
Es el valor que devuelve Save Asset en fileKey y el que devuelve Get File Keys en cada entrada de fileKeys.
Límites de uso de un asset
Un asset almacenado tiene dos límites de uso:
Un asset referenciado contiene un contenido ya procesado en otra operación
409
Un asset ha agotado el número máximo de invocaciones en ese endpoint
429
Volver a almacenar la misma captura bajo otra operación no permite validarla de nuevo. El presupuesto de invocaciones es independiente por operación, asset y endpoint; su valor se acuerda en el alta del servicio.
Excepciones
Los servicios de validación de identidad admiten por defecto los dos modos de asset, contenido en línea y referencia por clave. Estas son las excepciones:
Solo FILE
Solo contenido en línea, sin campo source
Solo referencia, sin campo source
En los servicios exclusivamente en línea el contenido se envía en la propia llamada y no llevan cabecera operation-id.
Servicios disponibles
Save Asset: Almacena un asset en un contexto de una operación y devuelve su clave.
Última actualización