الانتقال إلى المحتوى الرئيسي
POST
Python
يتحقق مجددًا من المستندات الموقّعة لخطوة ما، ويحفظ النتيجة في validation لكل موقّع. يعيد Didit قراءة كل ملف PDF موقّع ويتحقق من قيمة SHA-256 الخاصة به. وبالنسبة إلى التوقيع المتقدم (AES)، يتحقق أيضًا من توقيع PAdES والشهادة وبيانات الإلغاء والطابع الزمني. التوقيع البسيط لا يحتوي على توقيع رقمي، لذلك يُتحقق فقط من سلامة الملف. لا يُعاد توقيع أي مستند. في وحدة التحكم، يقابل ذلك زر التحقق مجددًا في تبويب التوقيع الخاص بالجلسة.
أرسل signature_id للتحقق من موقّع واحد. ومن دون هذا الحقل، يتحقق Didit من كل موقّعي الخطوة، ويرد بالرمز 409 مع signature_not_signed إذا لم يوقّع أحدهم. أما ملف PDF الموقّع المخزَّن الذي لم يعد يطابق sha256_signed، فيرد بالرمز 400 مع signature_document_changed. الاستجابة هي { "signatures": [...] } وتتضمن الموقّعين الذين جرى التحقق منهم. اقرأ validation.valid للحصول على النتيجة الإجمالية، وvalidation.documents[] لكل مستند. راجع التحقق من التوقيع مجددًا لمعرفة كل حقل.

ذات صلة

التفويضات

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"

الجسم

application/json
signature_id
string<uuid>

id لعنصر أحد الموقّعين في signatures[].

الاستجابة

الموقعون الذين تم فحصهم، مع تحديث validation الخاص بهم.

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