Obter Selfie

Retorna a selfie biométrica capturada pelo usuário durante a jornada hospedada pela Unico. A imagem é retornada como uma string codificada em base64 com uma marca d'água aplicada.

Disponível apenas para processos que executaram captura biométrica (qualquer fluxo que inclua Liveness ou Identity Verification). Não disponível para fluxos de Smart Revalidation (idsmart).

Endpoint

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

Requisição

Headers

Header	Valor
Authorization	Bearer <access_token> (consulte 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://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/selfie \
  -H "Authorization: Bearer $TOKEN"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.idcloud.unico.app/client/v1/process/${processId}/selfie`,
  { headers: { Authorization: `Bearer ${accessToken}` } }
);
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. Contém uma marca d'água.
contentType	string	Tipo MIME da imagem — image/jpeg ou image/png.

400 Bad Request

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

401 Unauthorized

Bearer token ausente, expirado ou inválido. Consulte Autenticação.

403 Forbidden

Permissões insuficientes para acessar a selfie deste processo.

404 Not Found

Processo não encontrado, ou a selfie não está disponível para este processo (ex.: fluxo de Smart Revalidation).

Códigos de Erro

observação

A API não expõe valores específicos de code ou message para este endpoint.

400 Bad Request

Nenhum valor específico de code ou message está documentado para este status.

401 Unauthorized

Nenhum valor específico de code ou message está documentado para este status.

403 Forbidden

Nenhum valor específico de code ou message está documentado para este status.

404 Not Found

Nenhum valor específico de code ou message está documentado para este status.

Próximos passos

• Para o resultado completo do processo, consulte Obter Processo.
• Para o pacote de auditoria de evidências, consulte Obter Conjunto de Evidências.