---
title: Obtenir le selfie
description: GET /v1/processes/{id}/selfie — lire le selfie capturé pour un processus, sa durée de disponibilité et les erreurs.
canonical: https://developer.unico.io/fr/human-plugin/api-reference/get-selfie
locale: fr
generated_by: markdown-export
---

# Obtenir le selfie

Lisez le selfie capturé pour un processus, avec l'id que Human Plugin a renvoyé à la création.

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

`id` est l'UUID de la réponse de création. La requête n'a ni corps ni paramètres de requête.

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

Human Plugin ne conserve pas de copie du selfie : chaque appel le récupère à nouveau.

## Réponse

`200 OK`, avec l'image en base64 et son type :

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

Pour l'enregistrer dans un fichier :

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

## Disponibilité

- Il n'y a un selfie que pour un processus qui en avait un : envoyé dans `imageBase64` ou capturé auprès de la personne.
- Avec un flux Journey, le selfie n'existe qu'une fois que la personne l'a capturé. Jusque-là, la requête est refusée avec un `400` et un `message` qui commence par `process state must be finished`. [Lisez le processus](/fr/human-plugin/api-reference/get-process) d'abord, puis récupérez le selfie quand il est `PROCESS_STATE_FINISHED`.
- Le selfie est disponible pendant une durée limitée après la fin du processus. Si vous en avez besoin plus tard, stockez-le à partir de cette réponse.

## Manipulation de l'image

Le selfie est une donnée biométrique. Human Plugin ne le stocke ni ne le journalise jamais, et la réponse est envoyée avec `Cache-Control: no-store`. Gardez-le aussi hors des journaux de votre passerelle et de votre application.

## Erreurs

| Statut | `message` | Signification |
| --- | --- | --- |
| 400 | `process state must be finished…` | Un processus Journey dont la capture n'est pas encore terminée. Lisez d'abord le processus |
| 404 | `PROCESS_NOT_FOUND` | L'id n'est pas un UUID ou est inconnu |
| 404 | `SELFIE_NOT_FOUND` | Le processus n'a pas de selfie : il n'y a pas eu de capture, il a échoué avant de démarrer, ou le selfie n'est plus disponible |
| 4xx | Le `message` du refus | La requête a été refusée. La raison figure dans `message` et `details` |
| 502 | `UPSTREAM_UNAVAILABLE` | Le selfie n'a pas pu être récupéré à temps. Réessayez plus tard |
| 503 | `DATABASE_UNAVAILABLE` | La base de données a échoué. Réessayez plus tard |

Les lectures peuvent être réessayées sans risque. Un `404` ne change pas lors d'une nouvelle tentative.

## Suite

[Cycle de vie d'un processus](/fr/human-plugin/api-reference/process-lifecycle)