跳转到主要内容
情报

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 理解为从未见过此人。

下一步​

前提条件与访问

最后更新 于