Obtenir le selfieGET

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

Markdown

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.

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 :

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

Pour l'enregistrer dans un fichier :

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