Get File Keys

Servicio que devuelve los assets almacenados en una operación, indexados por su contexto.

Es la vía recomendada para obtener las claves que se envían a los servicios de validación, en lugar de conservarlas en el cliente.

Endpoint

GET /operation/{operationId}/file-keys

Headers

Nombre	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de consumer en formato Bearer <token>. Ver Autenticación.
consumer-id	string	Sí	Identificador del consumer.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
operationId	string	Sí	Identificador de la operación.

Respuestas

200 Éxito

Parámetros de respuesta

Parámetro	Tipo	Descripción
operationId	string	Identificador de la operación.
merchantReference	string	La referencia indicada al crear la operación. No aparece si no se indicó ninguna.
fileKeys	object	Objeto indexado por contexto, donde cada valor es la clave del asset de ese contexto. Los contextos sin asset almacenado no aparecen.

Ejemplo de respuesta

{
  "operationId": "0192a3f4-7b21-7c44-9e1a-3f5b8c2d1e04",
  "merchantReference": "ORD-4417",
  "fileKeys": {
    "TOKEN_FRONT_DOCUMENT": "0192a3f4-7b21-7c44-9e1a-3f5b8c2d1e04/TOKEN_FRONT_DOCUMENT",
    "TOKEN_BACK_DOCUMENT": "0192a3f4-7b21-7c44-9e1a-3f5b8c2d1e04/TOKEN_BACK_DOCUMENT",
    "TOKEN_BEST_IMAGE": "0192a3f4-7b21-7c44-9e1a-3f5b8c2d1e04/TOKEN_BEST_IMAGE",
    "TOKEN_RAW_IMAGE": "0192a3f4-7b21-7c44-9e1a-3f5b8c2d1e04/TOKEN_RAW_IMAGE"
  }
}

Un asset subido con el contexto RAW_IMAGE aparece aquí bajo TOKEN_RAW_IMAGE, que es el contexto con el que queda almacenado. Ver Contextos de asset.

merchantReference se devuelve para reconciliar la operación con el sistema propio. No es un criterio de consulta: esta ruta se direcciona por operationId.

Otras respuestas

Código	Descripción
401	Token ausente, inválido o caducado.
403	El consumer no está aprovisionado con el servicio OPERATION.
404	La operación no existe o pertenece a otro consumer.
410	La operación declarada en operation-id ha caducado.
429	El consumer ha superado su límite de tasa de peticiones. La respuesta incluye Retry-After con los segundos de espera, y X-RateLimit-Limit y X-RateLimit-Burst con los umbrales vigentes.
503	El servicio no está disponible temporalmente.

El cuerpo de una respuesta de error tiene la forma descrita en Middleware API v2.