الانتقال إلى المحتوى الرئيسي
GET
Python
تُعيد الصورة بصيغة PNG التوقيع أو الأحرف الأولى التي وضعها الموقّع على أحد الحقول. المسار موجود في image_url الخاص بالحقل ضمن signatures[].documents[].fields[]، لذا لا حاجة لإنشائه بنفسك. يتطلب هذا المسار الصلاحية read:sessions.
التوقيع المرسوم هو الصورة التي رسمها الموقّع، وهي الصورة نفسها المختومة في ملف PDF الموقّع. أما التوقيع المكتوب فهو اسم الموقّع المُتحقَّق منه بنمط الخط الذي اختاره، ويحمله ملف PDF الموقّع كنص بالنمط نفسه. لإثبات التوقيع نفسه، استخدم المستند الموقّع والأدلة. يُعيد الحقل الذي لا يخص الموقّع، أو الذي لا يحتوي على توقيع أو أحرف أولى مُطبّقة، الاستجابة 404 مع signature_field_not_found. أما الصورة المخزّنة التي لم تعد تطابق قيمة SHA-256 المسجّلة لها فتُعيد 400 مع signature_document_changed. بعد أن تحذف الجلسة، يُعيد المسار 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"

fieldId
string<uuid>
مطلوب

الحقل الموجود في نسخة هذا الموقّع، كما هو في image_url الخاص بالحقل.

الاستجابة

الصورة.

The response is of type file.

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