Obter Selfie

MarkdownChatGPTClaude

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 para qualquer processo finalizado que tenha executado uma captura biométrica, incluindo jornadas de Revalidação Inteligente (idsmart). Não disponível quando o processo foi concluído sem captura biométrica (uma autenticação silenciosa, por exemplo), pois não há selfie para retornar.

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.

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

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 o processo foi concluído sem captura biométrica, portanto não há selfie para retornar.

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.