---
title: Obtener la selfie
description: GET /v1/processes/{id}/selfie — lee la selfie capturada para un proceso, cuánto tiempo está disponible y los errores.
canonical: https://developer.unico.io/es/human-plugin/api-reference/get-selfie
locale: es
generated_by: markdown-export
---

# Obtener la selfie

Lee la selfie capturada para un proceso, con el id que Human Plugin devolvió al crearlo.

`GET /v1/processes/{id}/selfie`

`id` es el UUID de la respuesta de creación. La solicitud no tiene cuerpo ni parámetros de consulta.

```bash
curl http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie
```

Human Plugin no guarda una copia de la selfie: cada llamada la obtiene de nuevo.

## Respuesta

`200 OK`, con la imagen en base64 y su tipo:

```json
{
  "fileContents": "/9j/4AAQSkZJRgABAQAAAQABAAD…",
  "contentType": "image/jpeg"
}
```

Para guardarla como archivo:

```bash
curl -s http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie \
  | jq -r .fileContents | base64 -d > selfie.jpg
```

## Disponibilidad

- Solo hay selfie para un proceso que tuvo una: enviada en `imageBase64` o capturada de la persona.
- Con un flujo Journey, la selfie existe solo después de que la persona la captura. Hasta entonces la solicitud se rechaza con `400` y un `message` que empieza con `process state must be finished`. [Lee el proceso](/es/human-plugin/api-reference/get-process) primero y obtén la selfie cuando esté en `PROCESS_STATE_FINISHED`.
- La selfie está disponible durante un tiempo limitado después de que el proceso finaliza. Si la necesitas más adelante, guárdala a partir de esta respuesta.

## Manejo de la imagen

La selfie es un dato biométrico. Human Plugin nunca la almacena ni la registra en logs, y la respuesta se envía con `Cache-Control: no-store`. Mantenla fuera también de los logs de tu gateway y de tu aplicación.

## Errores

| Status | `message` | Significado |
| --- | --- | --- |
| 400 | `process state must be finished…` | Un proceso Journey cuya captura aún no ha finalizado. Lee el proceso primero |
| 404 | `PROCESS_NOT_FOUND` | El id no es un UUID o es desconocido |
| 404 | `SELFIE_NOT_FOUND` | El proceso no tiene selfie: no tuvo captura, falló antes de empezar o la selfie ya no está disponible |
| 4xx | El `message` del rechazo | La solicitud fue rechazada. El motivo está en `message` y `details` |
| 502 | `UPSTREAM_UNAVAILABLE` | No se pudo obtener la selfie a tiempo. Reintenta más tarde |
| 503 | `DATABASE_UNAVAILABLE` | Falló la base de datos. Reintenta más tarde |

Las lecturas se pueden reintentar con seguridad. Un `404` no cambia al reintentar.

## Siguiente

[Ciclo de vida del proceso](/es/human-plugin/api-reference/process-lifecycle)