الانتقال إلى المحتوى الرئيسي
POST
curl

دعم KYC وKYB

يعمل هذا مع جلسات التحقق من المستخدمين (KYC) والتحقق من الشركات (KYB) معًا. يقوم Didit بمطابقة session_id مع نوعي الجلسات، وينشئ token مشاركة JWT يتضمن:
عندما يستورد الشريك المستلم الـtoken، يقوم Didit باستنساخ الجلسة من النوع المقابل (KYC أو KYB) مع علاقاتها.

المتطلبات

  • يجب أن تكون الجلسة في حالة منتهية (APPROVED أو DECLINED أو IN_REVIEW).
  • يجب أن تملك الصلاحية write:sessions.
  • يجب أن يكون for_application_id تطبيق Didit صالحًا (عادةً تطبيق الشريك).

الأمثلة

الاستجابة:

حدود مدة الصلاحية (TTL)

ذات صلة

التفويضات

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 لجلسة التحقق المصدر لإنشاء token لها.

مثال:

"11111111-2222-3333-4444-555555555555"

الجسم

application/json
for_application_id
string<uuid>
مطلوب

معرّف UUID لتطبيق Didit الذي سيسترد الـ token. يجب أن يكون موجوداً، وألا يكون محذوفاً، ويجب أن يختلف عن التطبيق المستدعي. يمكنك العثور عليه في Business Console ضمن Settings → Application.

مثال:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
افتراضي:3600

عمر token بالثواني. الحد الأدنى 60، والحد الأقصى 86400 (24 ساعة). القيمة الافتراضية هي 3600 (ساعة واحدة).

النطاق المطلوب: 60 <= x <= 86400
مثال:

3600

الاستجابة

تم إصدار token المشاركة.

share_token
string

JWT موقّع بـ HS256. مرِّر هذا كما هو كـ share_token إلى POST /v3/session/import-shared/ في التطبيق المستهدف.

مثال:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

يُكرر UUID الخاص بالتطبيق المستهدف المرتبط به الـ token.

مثال:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

ما إذا كانت الجلسة المصدر هي جلسة التحقق من المستخدمين (KYC) أو جلسة التحقق من الشركات (KYB).

الخيارات المتاحة:
user,
business
آخر تعديل في ٧ نوفمبر ٢٠٢٦