Аналитика

data.ndocs: что один и тот же человек делал у вас, в каждом ответе.

Markdown

Каждый завершённый процесс сообщает, кто этот человек, — через Human Token, и что этот человек делал у вас, — через аналитику в data.ndocs: с каким числом ваших клиентов его видели, сколько документов он использовал и когда.

"ndocs": {
  "distinctClientsCount": 2,
  "transactionsCount": 3,
  "firstSeen": "2026-09-08",
  "lastSeen": "2026-11-03",
  "credentials": [
    { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
  ]
}

Поле	Значение
distinctClientsCount	Число различных значений clientId среди процессов человека
transactionsCount	Число процессов человека, включая текущий
firstSeen, lastSeen	Даты в UTC (YYYY-MM-DD) самого раннего и самого позднего процесса
credentials[].type	Тип документа, код из каталога атрибутов
credentials[].countryCode	Страна выдачи документа в формате alpha-3. Отсутствует для типа, которого больше нет в каталоге
credentials[].distinctCredentialCount	Число различных документов этого типа

Как её читать

Значение distinctClientsCount больше 1 или distinctCredentialCount больше 1 означает, что одно и то же лицо использовалось с разными клиентами или документами. Что делать с этим сигналом, решаете вы.

Что учитывается

Человек определяется по Human Token. Учитываются только завершённые процессы с этим токеном, по всем вашим id клиентов. Процесс, созданный без документа, считается и как транзакция, и как клиент, но не относится ни к одному типу документа. credentials равно [], если ни у одного из процессов человека нет документа.

Аналитика охватывает процессы вашей установки Human Plugin.

Чья это аналитика

• Идентификация, завершившаяся с Human Token: этого человека. Не в случае, когда data.liveness.value равно not_live.
• Ревалидация с data.humanTokenMatch, равным "true": человека, чей токен вы передали в references. Процесс засчитывается этому человеку.
• В остальных случаях (отрицательное совпадение или захват без признаков живости): аналитики нет, и data.ndocs отсутствует.

Когда она отсутствует

data.ndocs может отсутствовать у известного человека:

• процесс ещё не завершён;
• аналитику не удалось вычислить. Создание или чтение при этом завершается успешно, а последующий GET повторяет попытку.

Не воспринимайте отсутствие data.ndocs как то, что человека раньше не видели.

Далее

Требования и доступ