Get SelfieGET

Recupere a selfie capturada durante um processo de Human Token.

Markdown

Retorna a selfie biométrica capturada pelo usuário durante um processo de Human Token. A imagem é retornada como uma string codificada em base64.

Disponível para qualquer processo finalizado que executou uma captura biométrica — todos os cinco fluxos de Human Token (api+humantoken, api+liveness+humantoken, api+liveness+humantoken+revalidation, humantoken, humantoken+revalidation). Não disponível quando o processo terminou sem captura biométrica, pois não há selfie para retornar.

aviso

A selfie fica disponível por 24 horas após o processo finalizar. Depois disso, a imagem é excluída permanentemente e este endpoint retorna 404.

Endpoint

Ambiente	URL
Produção	GET https://humantoken.unico.app/client/v1/process/{processId}/selfie

Requisição

Headers

Header	Valor
x-unico-accesskey	<your_access_key> (veja Autenticação)

Parâmetros de path

Parâmetro	Tipo	Obrigatório	Descrição
processId	string (UUID)	sim	Identificador do processo retornado por Criar Processo.

Exemplo

cURL

curl -X GET https://humantoken.unico.app/client/v1/process/$PROCESS_ID/selfie \
  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://humantoken.unico.app/client/v1/process/${processId}/selfie`,
  { headers: { 'x-unico-accesskey': process.env.UNICO_ACCESS_KEY } }
);
const { fileContents, contentType } = await res.json();
// fileContents is a base64-encoded image string

Respostas

200 OK

{
  "fileContents": "/9j/4AAQSkZJR...",
  "contentType": "image/jpeg"
}

Campo	Tipo	Descrição
fileContents	string (base64)	A selfie capturada, codificada em base64.
contentType	string	Tipo MIME da imagem — image/jpeg ou image/png.

Códigos de Erro

400 Bad Request

O parâmetro de path processId está ausente ou mal formatado.

401 Unauthorized

Access key ausente ou inválida no header x-unico-accesskey. Veja Autenticação.

403 Forbidden

Permissões insuficientes para acessar a selfie deste processo.

404 Not Found

Processo não encontrado, o processo finalizou sem captura biométrica, ou a janela de retenção de 24 horas expirou.

429 Too Many Requests

Rate limit reached. When your system receives an HTTP 429 error, you must implement mechanisms to prevent cascading failures and avoid worsening the restriction.

Best practices:

• Cool-down period (backoff): Immediately halt or throttle subsequent requests from your system. Do not continuously retry failed requests in a tight loop.
• Queueing & throttling: Buffer or queue outgoing requests on your end to control the traffic flow before re-sending them.
• Exponential backoff with jitter: When retrying, increase the waiting time exponentially between attempts (e.g., 1 s, 2 s, 4 s, 8 s) and add a small random delay ("jitter") to prevent a herd effect where all queued requests retry at the exact same millisecond.

aviso

Continuously hitting a rate-limited endpoint without backing off can prolong the restriction period and severely impact your system's operational throughput. Properly throttling requests on your side ensures a smoother, more resilient integration.

For default limits, increase requests and additional details, see Rate Limits.

Próximos passos

• Para o resultado completo do processo, veja Obter Processo.
• Volte para Criar Processo para enviar uma nova selfie.