واجهة برمجة التطبيقات للتوقيع الإلكتروني (API)

ماذا يعني «واجهة برمجة التطبيقات للتوقيع الإلكتروني»؟

واجهة برمجة التطبيقات (API) للتوقيع الإلكتروني واجهة برمجية تتيح لبرنامجك إرسال المستندات للتوقيع وتتبّع حالتها واسترجاع الملفات الموقّعة، دون أن يضغط أحد عبر تطبيق الويب لدى المزوّد. باختصار، هي الطريقة التي يؤتمت بها المطوّرون التوقيع ويربطونه بأنظمة إدارة العملاء (CRM) وأنظمة الموارد البشرية والمنتجات المخصّصة.

يعمل التكامل النموذجي هكذا: يصادق نظامك باستخدام مفتاح API، ويرسل طلبًا لإنشاء طلب توقيع من ملف PDF أو من قالب، ويحدد الموقّعين وترتيبهم، ثم يتلقى معرّفًا. بعد ذلك يرسل المزوّد بريدًا إلى الموقّعين أو يُعيد رابطًا لـالتوقيع المدمج. وعندما يتغير شيء، كتوقيع أو رفض، يستدعي المزوّد الـwebhook لديك، فينزّل نظامك المستند المكتمل وسجل التدقيق الخاص به.

خذ مثلًا وكالة توظيف تُلحق متعاقدين بالعمل كل أسبوع. بدلًا من أن يرفع موظف التوظيف كل اتفاقية يدويًا، يستدعي نظام تتبّع المتقدمين الواجهة البرمجية لحظة تأكيد التعيين، فيملأ القالب ببيانات المتعاقد، ويحفظ النسخة الموقّعة في ملف المرشح تلقائيًا.

من المفاهيم الخاطئة أن واجهة API مخصّصة للمؤسسات الكبيرة فقط. فالفرق الصغيرة التي لديها مسار عمل واحد متكرر يمكنها الاستفادة أيضًا، وكثيرًا ما تستطيع أدوات العمل دون برمجة استدعاء الواجهة نيابةً عنك. ومن المفاهيم الخاطئة كذلك أن المستندات الموقّعة عبر API مختلفة قانونيًا بطريقة ما؛ فهي التوقيعات نفسها مع سجل التدقيق نفسه، غير أن الشيفرة هي التي بدأتها.

الواجهة البرمجية هي أساس التوقيع المدمج، وغالبًا أساس الإرسال الجماعي أيضًا، وهي تعتمد عادةً على القوالب حتى تُنشأ المستندات بشكل متّسق.

عند تقييم أي واجهة برمجية للتوقيع الإلكتروني، انظر إلى التفاصيل العملية: توثيق واضح، وبيئة تجريبية أو وضع اختبار، وحدود معقولة لمعدل الطلبات، وإعادة محاولة الـwebhooks، وإمكانية تنزيل ملف PDF الموقّع وسجل التدقيق معًا. وتحقق من طريقة الإبلاغ عن الأخطاء، ومن قدرة الواجهة على استخدام القوالب نفسها التي يديرها فريقك في تطبيق الويب. هذه التفاصيل هي التي تحدد ما إذا كان التكامل سيستغرق يومًا أو شهرًا، وما إذا كان سيستمر في العمل بهدوء بعد الإطلاق.

رأينا: إذا كان التوقيع خطوة في عملية يديرها برنامجك أصلًا، فالواجهة البرمجية توفّر ساعات حقيقية وتمنع أخطاء النسخ واللصق. أما إذا كنت ترسل بضعة عقود في الأسبوع، فتطبيق الويب أسرع في الإعداد وأسهل في الصيانة.

واجهة eSignSimple البرمجية من نوع REST متاحة الآن: صادِق بمفتاح API من نوع Bearer، وأنشئ المستندات وأرسلها من ملف PDF أو قالب، وتتبّع الحالة وسجل التدقيق، ونزّل ملف PDF الموقّع، واحصل على webhooks عند اكتمال المستندات أو رفضها أو إلغائها. أما حزم SDK والبيئة التجريبية والتوقيع المدمج فهي ضمن خارطة طريقنا. ويتضمن كل مستند مكتمل سجل تدقيق وشهادة إتمام التوقيع وبصمة SHA-256 يمكن التحقق منها على صفحتنا العامة. والمرجع الكامل موجود في صفحة توثيق المطوّرين.

«واجهة برمجة التطبيقات للتوقيع الإلكتروني»: مثال واقعي

شركة برمجيات سحابية صغيرة تريد أن يوقّع كل عميل مؤسسي جديد نموذج الطلب تلقائيًا. عندما تُعلَّم الصفقة كصفقة رابحة في نظام CRM لديها، يستدعي سكربت واجهة eSignSimple البرمجية بمفتاح API، وينشئ مستندًا من قالب نموذج الطلب ببيانات العميل، ثم يرسله. ويُبلغ webhook نظامها عند اكتمال المستند، فينزّل السكربت ملف PDF الموقّع إلى سجل العميل.

ما المصطلحات ذات الصلة؟

• القالب: قالب التوقيع الإلكتروني مستند قابل لإعادة الاستخدام بأدوار موقّعين وحقول معدّة مسبقًا، فترسل الاتفاقية نفسها مرارًا دون إعدادها من جديد.
• الإرسال الجماعي: الإرسال الجماعي يتيح لك إرسال مستند أو قالب واحد إلى مستلمين كثيرين دفعة واحدة، فيتلقى كل شخص نسخته الخاصة ويوقّعها.
• نموذج الويب (رابط التوقيع): نموذج الويب في التوقيع الإلكتروني صفحة مستضافة للتعبئة والتوقيع برابط عام، تتيح لأي شخص إكمال مستند وتوقيعه دون دعوة مسبقة.
• التوقيع المدمج (Embedded signing): التوقيع المدمج يتيح للأشخاص توقيع المستندات داخل موقعك أو تطبيقك نفسه، بدلًا من اتباع رابط في بريد إلكتروني إلى موقع مزوّد التوقيع الإلكتروني.