---
title: 情报 (data.ndocs)
description: 情报是 Human Plugin 在每个响应的 data.ndocs 中提供的关于每个人的信息，包括它描述的对象、统计的内容、何时缺失以及如何解读。
canonical: https://developer.unico.io/zh-CN/human-plugin/get-started/intelligence
locale: zh-CN
generated_by: markdown-export
---

# 情报

data.ndocs：同一个人在您这里做过什么，每个响应都会给出。

每个已完成的流程都会告诉您此人是谁（通过 Human Token），以及此人在您这里做过什么（通过 `data.ndocs` 中的情报）：此人曾出现在您的多少个客户下、使用过多少份文件，以及发生的时间。

```json
"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` | 文件类型，是[属性目录](/zh-CN/human-plugin/additional-resources/attribute-catalog)中的代码 |
| `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` 理解为从未见过此人。

## 下一步

[前提条件与访问](/zh-CN/human-plugin/get-started/prerequisites)