---
title: المعلومات الاستخباراتية (data.ndocs)
description: المعلومات الاستخباراتية هي ما يخبرك به Human Plugin عن كل شخص في كل استجابة، في data.ndocs — من تصفه، وما الذي تعدّه، ومتى تغيب، وكيف تقرأها.
canonical: https://developer.unico.io/ar/human-plugin/get-started/intelligence
locale: ar
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` | نوع الوثيقة، وهو رمز من [كتالوج السمات](/ar/human-plugin/additional-resources/attribute-catalog) |
| `credentials[].countryCode` | البلد المُصدِر للوثيقة بصيغة Alpha-3. يغيب في حالة نوع لم يعد الكتالوج يدرجه |
| `credentials[].distinctCredentialCount` | عدد الوثائق المتميزة من ذلك النوع |

## كيف تقرأها

إذا كانت قيمة `distinctClientsCount` أكبر من 1، أو `distinctCredentialCount` أكبر من 1، فهذا يعني أن الوجه نفسه استُخدم مع عملاء أو وثائق مختلفة. وما تفعله بهذه الإشارة قرارك أنت.

## ما الذي يُعدّ

يُعرَّف الشخص بواسطة Human Token. لا تُعدّ إلا العمليات **المنتهية** التي تحمل هذا الرمز، عبر جميع معرّفات العملاء لديك. العملية المنشأة بلا وثيقة تُحتسب معاملة وعميلاً، لكن تحت أي نوع وثيقة. تكون `credentials` مساوية لـ `[]` عندما لا تحتوي أي من عمليات الشخص على وثيقة.

تغطي المعلومات الاستخباراتية عمليات تثبيت Human Plugin الخاص بك.

## لمن تعود المعلومات

- **التعريف** المنتهي بـ Human Token: ذلك الشخص. وليس كذلك عندما تكون `data.liveness.value` هي `not_live`.
- **إعادة التحقق** مع كون `data.humanTokenMatch` تساوي `"true"`: صاحب الرمز الذي أرسلته في `references`. تُحتسب العملية لذلك الشخص.
- **في غير ذلك** (مطابقة سلبية، أو التقاط غير حي): لا معلومات استخباراتية، ولا `data.ndocs`.

## متى تغيب

قد يغيب `data.ndocs` عن شخص معروف:

- لم تنتهِ العملية بعد؛
- تعذّر حساب المعلومات الاستخباراتية. ينجح الإنشاء أو القراءة مع ذلك، وتحاول `GET` لاحقة مرة أخرى.

لا تفسّر غياب `data.ndocs` على أنه شخص لم يُرَ من قبل.

## التالي

[المتطلبات الأساسية والوصول](/ar/human-plugin/get-started/prerequisites)