Consultar a selfieGET

Consulte a selfie capturada para um processo, pelo id que o Human Plugin retornou na criação.

Markdown

GET /v1/processes/{id}/selfie

id é o UUID da resposta de criação. A requisição não tem corpo nem parâmetros de query.

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

O Human Plugin não guarda uma cópia da selfie: cada chamada a busca novamente.

Resposta

200 OK, com a imagem em base64 e seu tipo:

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

Para salvá-la como arquivo:

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

Disponibilidade

• Só há selfie para um processo que teve uma: enviada em imageBase64 ou capturada da pessoa.
• Em um fluxo Journey, a selfie só existe depois que a pessoa a captura. Até lá, a requisição é recusada com 400 e uma message que começa com process state must be finished. Consulte o processo primeiro e busque a selfie quando ele estiver em PROCESS_STATE_FINISHED.
• A selfie fica disponível por um tempo limitado depois que o processo termina. Se precisar dela mais tarde, armazene-a a partir desta resposta.

Como tratar a imagem

A selfie é um dado biométrico. O Human Plugin nunca a armazena nem a registra em logs, e a resposta é enviada com Cache-Control: no-store. Mantenha-a fora dos logs do seu gateway e da sua aplicação também.

Erros

Status	message	Significado
400	process state must be finished…	Um processo Journey cuja captura ainda não terminou. Consulte o processo primeiro
404	PROCESS_NOT_FOUND	O id não é um UUID ou é desconhecido
404	SELFIE_NOT_FOUND	O processo não tem selfie: não houve captura, ele falhou antes de começar ou a selfie não está mais disponível
4xx	A message da recusa	A requisição foi recusada. O motivo está em message e details
502	UPSTREAM_UNAVAILABLE	Não foi possível buscar a selfie a tempo. Tente novamente mais tarde
503	DATABASE_UNAVAILABLE	O banco de dados falhou. Tente novamente mais tarde

As consultas podem ser repetidas com segurança. Um 404 não muda ao tentar de novo.

Próximo passo

Ciclo de vida do processo