Obtener la selfieGET

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

Markdown

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.

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:

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

Para guardarla como archivo:

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 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