الانتقال إلى المحتوى الرئيسي
GET
cURL

دعم KYC وKYB

يعمل هذا مع جلسات التحقق من المستخدمين (KYC) والتحقق من الشركات (KYB). يوجّه Didit الجلسة تلقائياً إلى قالب PDF المناسب:
  • جلسة التحقق من المستخدمين (KYC) ← تقرير يتضمن أقسام التحقق من الهوية، وكشف الحيوية، ومطابقة الوجه، وAML، وإثبات العنوان.
  • جلسة التحقق من الشركات (KYB) ← تقرير يتضمن أقسام سجل الشركات، والأشخاص الرئيسيين (UBOs والمسؤولين)، والمستندات، وAML، والاستبيان، والهاتف، والبريد الإلكتروني، وتحليل عنوان IP، وذلك عندما تكون هذه الميزات جزءاً من سير العمل.
يستخدم الاثنان مسار إنشاء PDF نفسه، ويدعمان تخصيص العلامة البيضاء (الشعار ورابط سياسة الخصوصية).

اصطلاح اسم الملف

يُعاد الملف عبر الرأس Content-Disposition: attachment; filename=....

متطلب الحالة

يجب أن تكون الجلسة في حالة APPROVED أو DECLINED أو IN_REVIEW لإنشاء ملف PDF. الجلسات قيد التنفيذ أو التي لم تبدأ بعد تُعيد 403.

أمثلة

العلامة البيضاء

عند تفعيل تخصيص العلامة البيضاء للتطبيق، يستخدم ملف PDF شعارك ورابط سياسة الخصوصية الخاص بك. يُضبط ذلك من Console → Customization.

الإذن

يتطلب read:sessions. النطاق نفسه لكلا النوعين.

مواضيع ذات صلة

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

معلمات المسار

sessionId
string<uuid>
مطلوب

معرّف UUID لجلسة التحقق من المستخدمين (KYC) أو التحقق من الشركات (KYB) المراد عرضها — وهو session_id الذي تم إرجاعه بواسطة POST /v3/session/. يعمل المسار نفسه لكلا نوعي الجلسات؛ استخدم اسم الملف في Content-Disposition بالاستجابة لمعرفة نوع التقرير الذي تلقيته.

يجب أن يكون معرّف UUID منسقاً بشكل سليم وبأحرف صغيرة. يتطابق المسار فقط مع معرّفات UUID الصالحة، لذا يتم رفض أي قيمة غير صحيحة التنسيق بواسطة موجه URL قبل تشغيل أي تعليمات برمجية للتطبيق، وتكون الاستجابة صفحة HTML برمز 404 بدلاً من غلاف JSON {"detail": ...} الموضح أدناه. لا يتطابق محول UUID للمسار إلا مع الصيغة القياسية ذات الأحرف الصغيرة — ويتم رفض معرّفات UUID الست عشرية ذات الأحرف الكبيرة برمز HTML 404.

مثال:

"11111111-2222-3333-4444-555555555555"

الاستجابة

مستند PDF المُصيَّر، يتم إرجاعه مباشرة كملف ثنائي application/pdf — لا يوجد غلاف JSON ولا إعادة توجيه عبر رابط تنزيل. يبدأ جسم الاستجابة ببايتات %PDF السحرية (PDF 1.7). احفظه في ملف بصيغة .pdf أو مرره مباشرة كبث إلى المتصل بك.

The response is of type file.

آخر تعديل في ٧ نوفمبر ٢٠٢٦