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.

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).

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.

404 Not Found

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

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.