Получение набора доказательств
Возвращает пакет доказательств, сформированный во время биометрического захвата, — пакет, содержащий снятые изображения, метаданные и артефакты захвата, используемые для подтверждения того, что проверка живости была выполнена в контролируемых условиях.
Доступно только для завершённых процессов (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"
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
Ответы
200 OK
{
"fileContents": "JVBERi0xLjMNCi...",
"contentType": "application/pdf"
}
| Поле | Тип | Описание |
|---|---|---|
fileContents | string (base64) | Пакет доказательств в кодировке base64. |
contentType | string | MIME-тип — обычно application/pdf. |
Коды ошибок
примечание
API не предоставляет специфичных значений code или message для этого эндпоинта.
- 400 Bad Request
- 401 Unauthorized
- 404 Not Found
- 500 Internal Server Error
Параметр пути processId отсутствует или имеет неверный формат.
Bearer-токен отсутствует, истёк или недействителен. См. Аутентификация.
Процесс не найден, либо набор доказательств ещё недоступен (процесс не завершён).
| Код | Сообщение | Описание |
|---|---|---|
99999 | Internal failure! Try again later | Когда произошла внутренняя ошибка. |
Что дальше
- Для полного результата процесса см. Получение процесса.
- Для снятого изображения селфи см. Получение селфи.