GEThttps://api.veriko.mx/v1/validations/{id}/image

Obtener la imagen del comprobante

Audiencia: public
Autenticación: API key
Permiso: validations:read

Devuelve el comprobante conservado de una validación por OCR, con caché privada:

Imagen: se entrega con disposición inline.
PDF: se entrega siempre como adjunto (attachment) y con Content-Security-Policy: sandbox, para que un navegador no lo abra dentro del propio origen.

Si la validación no tiene imagen disponible, responde con un estado HTTP 404 (con image_not_available en el cuerpo).

Si la validación se creó con retain_image=false, responde con un estado HTTP 410 (con image_not_retained en el cuerpo); si se purgó, con un estado HTTP 410 (con validation_purged en el cuerpo). Un 410 no se resuelve reintentando: el archivo no existe.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`*	path	`string (uuid)`	obligatorio	Identificador (UUID) de la validación

Petición

cURLPython•JavaScript•PHP•

curl -X GET 'https://api.veriko.mx/v1/validations/{id}/image' \
  -H 'Authorization: Bearer veriko_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Códigos de respuesta**`GET /v1/validations/{id}/image`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Comprobante. `Content-Type` indica `image/png`, `image/jpeg`, `image/webp` o `application/pdf` según el formato; cualquier otro contenido se entrega como `application/octet-stream`.	Cuerpo sin schema
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`
404	`4xx`	Validación no encontrada (`not_found`) o sin imagen disponible (`image_not_available`).	`ErrorResponse`
410	`4xx`	La imagen no existe por decisión del cliente: la validación se creó con `retain_image=false` (`image_not_retained`) o se purgó (`validation_purged`).	`ErrorResponse`
422	`4xx`	UUID inválido en la ruta (`invalid_uuid`).	`ErrorResponse`

**Cabeceras de respuesta**`200`
Cabecera	Tipo	Descripción
`Cache-Control`	`string`	Permite un caché privado durante 1 hora.
`Content-Disposition`	`string`	`inline` para una imagen y `attachment` para un PDF, con un nombre derivado del identificador de la validación y la extensión del formato.
`Content-Security-Policy`	`string`	Sólo con un PDF. `sandbox` impide ejecutar scripts y trata el documento como de otro origen si un visor lo abre.
`Cross-Origin-Resource-Policy`	`string`	Restringe el uso del recurso al mismo origen.
`X-Content-Type-Options`	`string`	Impide que el navegador deduzca un tipo de contenido distinto.

**Errores de `GET /v1/validations/{id}/image`**
Código	Clave	Ejemplo
401	`unauthorized`	Credenciales de autenticación ausentes o inválidas. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	No tienes permiso para acceder a este recurso. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`