Получение процессаGET

Чтение процесса по id, который Human Plugin вернул при создании.

Markdown

GET /v1/processes/{id}

id — это UUID из ответа на создание. Заголовка аутентификации и привязки к клиенту нет: любой вызывающий, который может обратиться к Human Plugin, может прочитать любой из его процессов.

curl http://human-plugin.internal:8080/v1/processes/b063041c-7529-4e70-a2b4-c71c00f19801

Когда приходит результат

• Ожидающий процесс (PROCESS_STATE_CREATED) проверяется при каждом чтении, и как только появляется результат, ответ содержит его.
• Завершённый или неудавшийся процесс окончателен, и ответ возвращается как есть.
• Прерванное создание отдаётся как неудавшееся примерно через 70 секунд после начала.

Чтение — единственный способ продвинуть ожидающий процесс: фонового задания нет, а возврат на ваш callbackUri не обновляет Human Plugin.

Ответ

200 OK с той же структурой, что и при создании: id, state и data.

Ожидающий Journey:

{ "id": "b063041c-7529-4e70-a2b4-c71c00f19801", "state": "PROCESS_STATE_CREATED", "data": {} }

Завершённые и неудавшиеся процессы

Завершённый процесс возвращает результат в data: кто этот человек — в humanToken, и аналитику по человеку — в ndocs, а также liveness, если поток её проверяет. Ревалидация вместо humanToken возвращает humanTokenMatch. Каждое поле описано в разделе Результат в data. Неудавшийся процесс возвращает PROCESS_STATE_FAILED с пустым data.

Завершённый процесс:

{
  "id": "b063041c-7529-4e70-a2b4-c71c00f19801",
  "state": "PROCESS_STATE_FINISHED",
  "data": {
    "humanToken": { "value": "6d3d71…", "status": "validated" },
    "liveness": { "value": "live", "status": "validated" },
    "ndocs": {
      "distinctClientsCount": 2,
      "transactionsCount": 3,
      "firstSeen": "2026-09-08",
      "lastSeen": "2026-11-03",
      "credentials": [
        { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
      ]
    }
  }
}

Завершённая ревалидация, где ndocs описывает человека, которого вы подтвердили:

{
  "id": "7f2c9a10-3d4e-4b5f-8a61-0c9e2d7b4a35",
  "state": "PROCESS_STATE_FINISHED",
  "data": {
    "humanTokenMatch": "true",
    "liveness": { "value": "live", "status": "validated" },
    "ndocs": {
      "distinctClientsCount": 2,
      "transactionsCount": 4,
      "firstSeen": "2026-09-08",
      "lastSeen": "2026-11-04",
      "credentials": [
        { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
      ]
    }
  }
}

Неудавшийся процесс:

{ "id": "c41e8b27-95d0-4a8f-b3e6-2f7a1d9c0e58", "state": "PROCESS_STATE_FAILED", "data": {} }

token и link Journey возвращаются только при создании. Сохраните их из того ответа.

Ошибки

Статус	message	Значение
404	PROCESS_NOT_FOUND	Id не является UUID или неизвестен
502	UPSTREAM_UNAVAILABLE	Процесс ожидает, и его результат не удалось проверить. Повторите позже
503	DATABASE_UNAVAILABLE	Сбой базы данных. Повторите позже

Чтение безопасно повторять.

Далее

Получение селфи