Получение набора доказательств
Возвращает пакет доказательств, сформированный во время биометрического захвата, — пакет, содержащий снятые изображения, метаданные и артефакты захвата, используемые для подтверждения того, что проверка живости была выполнена в контролируемых условиях.
Доступно только для завершённых процессов (state = PROCESS_STATE_FINISHED).
Эндпоинт
| Среда | URL |
|---|---|
| Production | GET https://api.idcloud.unico.app/client/v1/process/{processId}/evidenceset |
| Sandbox | GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/evidenceset |
Запрос
| Заголовок | Значение |
|---|---|
Authorization | Bearer <access_token> (см. Аутентификация) |
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
processId | string (UUID) | да | Идентификатор процесса, возвращённый Создать процесс. |
Пример
- cURL
- Node.js
curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/evidenceset \
-H "Authorization: Bearer $TOKEN" \
| jq -r .fileContents | base64 --decode > evidence-set.pdf
import { writeFile } from 'node:fs/promises';
async function getEvidenceSet(processId) {
const response = await fetch(
`https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
{ headers: { Authorization: `Bearer ${accessToken}` } }
);
if (!response.ok) throw new Error(`Get Evidence Set failed with ${response.status}`);
const { fileContents } = await response.json();
// fileContents — это PDF-файл в кодировке base64
return Buffer.from(fileContents, 'base64');
}
// Сохранить PDF на диск
await writeFile(`evidence-set-${processId}.pdf`, await getEvidenceSet(processId));
// Или отправить в браузер (Express)
app.get('/processes/:id/evidence-set', async (req, res) => {
const pdf = await getEvidenceSet(req.params.id);
res
.type('application/pdf') // не передавайте contentType дальше: API возвращает "x-pdf"
.set('Content-Disposition', 'inline; filename="evidence-set.pdf"')
.send(pdf);
});
Ответы
{
"fileContents": "JVBERi0xLjMNCi...",
"contentType": "x-pdf"
}
| Поле | Тип | Описание |
|---|---|---|
fileContents | string (base64) | PDF набора доказательств, в кодировке base64. |
contentType | string | В настоящее время возвращает x-pdf. |
x-pdf не является допустимым MIME-типом, и браузеры его не распознают. Не передавайте contentType в браузер. Декодируйте fileContents из base64 и отдавайте байты как application/pdf, как в примере Node.js выше.
Коды ошибок
API не предоставляет специфичных значений code или message для этого эндпоинта.
- 400 Bad Request
- 401 Unauthorized
- 404 Not Found
- 500 Internal Server Error
Параметр пути processId отсутствует или имеет неверный формат.
Bearer-токен отсутствует, истёк или недействителен. См. Аутентификация.
Процесс не найден, либо набор доказательств ещё недоступен (процесс не завершён).
| Код | Сообщение | Описание |
|---|---|---|
99999 | Internal failure! Try again later | Когда произошла внутренняя о шибка. |
Что дальше
- Для полного результата процесса см. Получение процесса.
- Для снятого изображения селфи см. Получение селфи.