واجهة برمجة التطبيقات
أرسل المستندات للتوقيع وتابعها من أنظمتك الخاصة عبر واجهة REST في إنستاسبيس.
تتيح واجهة برمجة التطبيقات في إنستاسبيس للأنظمة الخارجية التعامل مع قوالب التوقيع الإلكتروني في مساحة عملك: سردها، وإرسال طلبات التوقيع، واستطلاع حالتها، وتنزيل المستندات الموقّعة. وهي وسيلتك لربط إنستاسبيس بنظام إدارة علاقات العملاء، أو أداة استقبال الطلبات، أو سير عمل داخلي ينتج عقودًا.
وتقع كل نقاط النهاية تحت عنوان أساسي واحد:
https://api.instaspace.ai/api/v1المصادقة
أنشئ مفتاح واجهة برمجة لمساحة العمل واستخدمه كرمز Bearer.
القوالب
اسرد القوالب المنشورة التي يمكنك الإرسال منها.
طلبات التوقيع
أرسل قالبًا للتوقيع، واستطلع الحالة، ونزّل النتيجة.
الأخطاء والحدود
رموز الحالة، وحدود المعدّل، والحصص الشهرية للخطط.
المرجع التقني
كل نقطة نهاية ومعاملاتها واستجاباتها — مولَّدة من الواجهة نفسها، فلا تتقادم أبدًا.
المرجع
تشرح الصفحات هنا كيف تتكامل أجزاء الواجهة. أما الشكل الدقيق لكل نقطة نهاية — المعاملات،
وأجسام الطلبات، وحقول الاستجابة، ورموز الحالة — فاستخدم له
المرجع التقني، وهو مولَّد من الواجهة العاملة لا
مكتوب يدويًا، ويغطّي فقط نقاط النهاية التي يستطيع مفتاح مساحة العمل استدعاءها. والمخطّط
القابل للقراءة آليًا متاح على
/api/v1/openapi.json إن أردت توليد
عميل.
يستطيع المرجع إرسال طلبات حقيقية. ونقاط النهاية القرائية آمنة للتجربة، لكن POST
/esign/submissions يرسل مستندًا فعليًا — إذ يراسل الموقّعين بالبريد ويستهلك أحد طلبات
التوقيع الشهرية لمساحة عملك. جرّب تلك النقطة من مساحة عمل اختبارية.
الواجهة متاحة في كل خطة مدفوعة — الخطط نفسها التي تشمل التوقيع الإلكتروني داخل التطبيق. وتُحتسَب الطلبات المرسَلة بمفتاح مساحة العمل ضمن حصة طلبات التوقيع الشهرية نفسها التي تُحتسَب منها الطلبات المرسَلة من التطبيق.