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 é finalizado sem uma captura biométrica (uma autenticação silenciosa, por exemplo), já que 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

Cabeçalhos

Cabeçalho	Valor
Authorization	Bearer <access_token> (veja Autenticação)

Parâmetros de caminho

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 é uma string de imagem codificada em base64

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 caminho processId está ausente ou malformado.

401 Unauthorized

Token Bearer ausente, expirado ou inválido. Veja Autenticação.

403 Forbidden

Permissões insuficientes para acessar a selfie deste processo.

404 Not Found

Processo não encontrado, ou o processo foi finalizado sem uma captura biométrica, portanto não há selfie para retornar.

Próximos passos

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