المعلومات الاستخباراتية

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. لا تُعدّ إلا العمليات المنتهية التي تحمل هذا الرمز، عبر جميع معرّفات العملاء لديك. العملية المنشأة بلا وثيقة تُحتسب معاملة وعميلاً، لكن تحت أي نوع وثيقة. تكون credentials مساوية لـ [] عندما لا تحتوي أي من عمليات الشخص على وثيقة.

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

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

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

متى تغيب

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

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

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

التالي

المتطلبات الأساسية والوصول