Obter conjunto de evidências

Retorna o pacote de evidências gerado durante a captura biométrica — um conjunto contendo as imagens capturadas, metadados e artefatos de captura utilizados para comprovar que a detecção de vivacidade foi realizada em condições controladas.

Disponível apenas para processos concluídos (state = PROCESS_STATE_FINISHED).

Endpoint

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

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/evidenceset \
  -H "Authorization: Bearer $TOKEN"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
  { headers: { Authorization: `Bearer ${accessToken}` } }
);
const { fileContents, contentType } = await res.json();
// fileContents is a base64-encoded PDF bundle

Respostas

200 OK

{
  "fileContents": "JVBERi0xLjMNCi...",
  "contentType": "application/pdf"
}

Campo	Tipo	Descrição
fileContents	string (base64)	O pacote de evidências, codificado em base64.
contentType	string	Tipo MIME — normalmente application/pdf.

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. Consulte Códigos de Erro abaixo.

401 Unauthorized

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

404 Not Found

Processo não encontrado, ou o conjunto de evidências ainda não está disponível (processo não finalizado).

500 Internal Server Error

Code	Message	Descrição
99999	Internal failure! Try again later	Quando ocorre um erro interno.

Próximos passos

• Para o resultado completo do processo, consulte Obter Processo.
• Para a imagem da selfie capturada, consulte Obter Selfie.