الانتقال إلى المحتوى الرئيسي
GET
Python
يُرجع ملف PDF الموقّع لمستند واحد، بعد أن يوقّعه الموقّع. لا تحتاج إلى بناء عنوان URL: كل مستند موقّع في القرار يحمل مساره في signatures[].documents[].signed_file.
يحتوي الملف على المستند الذي عُرض على الموقّع مع قيم الحقول الخاصة به مطبوعةً عليه، وصفحة الأدلة (ما لم تكن signature_evidence_page في الخطوة معطّلة). يحتوي ملف PDF من نوع Advanced (AES) أيضاً على توقيع PAdES مع طابعه الزمني، أما ملف PDF البسيط فلا يحتوي على توقيع رقمي أو ختم أو طابع زمني. قبل إرجاع الملف، يتحقق Didit من الملف المخزَّن مقابل sha256_signed، ويُرجع 409 مع signature_document_changed إذا اختلفا. المستند الذي لم يُوقَّع بعد يُرجع 404 مع signature_not_signed. بعد أن تحذف الجلسة، يُرجع المسار 404.

ذات صلة

التفويضات

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>
مطلوب

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

مثال:

"11111111-2222-3333-4444-555555555555"

nodeId
string
مطلوب

خطوة التوقيع الإلكتروني: node_id الخاص بالعنصر في signatures[].

مثال:

"feature_signature"

documentId
string<uuid>
مطلوب

id للمستند في signatures[].documents[].

الاستجابة

ملف PDF الموقّع.

The response is of type file.

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