الأخطاء والحدود
رموز الحالة، وحدود المعدّل، والحصة الشهرية لطلبات التوقيع في كل خطة.
استجابات الأخطاء
تستخدم الأخطاء رموز حالة HTTP المعتادة مع جسم JSON يصف المشكلة:
| الحالة | متى تحدث |
|---|---|
400 | فشل جسم الطلب في التحقّق — دور مفقود، أو حقل غير معروف في values، أو بريد إلكتروني بصيغة خاطئة. وتسرد الرسالة ما ينبغي إصلاحه. |
401 | لا يوجد مفتاح واجهة، أو المفتاح غير صالح أو مُبطَل أو منتهي الصلاحية. |
403 | المفتاح يعمل لكن الإجراء غير مسموح — الخطة لم تعد تشمل التوقيع الإلكتروني، أو غادر منشئ المفتاح مساحة العمل، أو استُنفدت الحصة الشهرية (limit_reached:signatureRequests). |
404 | معرّف غير معروف — بما في ذلك القوالب الموجودة لكن غير المنشورة. |
429 | تجاوز حدّ المعدّل. |
حدّ المعدّل
تخضع الطلبات لحدّ معدّل لكل عميل قدره 120 طلبًا في الدقيقة. وبعد ذلك تعيد الطلبات
429 حتى تنقضي نافذة الدقيقة. وإن كنت تستطلع حالة عدد كبير من طلبات التوقيع، فوزّع
الاستطلاعات بدل إرسالها دفعةً واحدة.
الحصة الشهرية لطلبات التوقيع
إرسال طلب توقيع — من التطبيق أو عبر الواجهة — يُحتسَب من الحصة الشهرية لمساحة عملك، وهي تُجدَّد في بداية كل شهر ميلادي (بتوقيت UTC):
| الخطة | طلبات التوقيع / الشهر |
|---|---|
| المبتدئة | 1 |
| الاحترافية | 10 |
| Max | 25 |
| فريق قياسية | 50 (لمساحة العمل كاملة) |
| فريق مميّزة | 100 (لمساحة العمل كاملة) |
| المؤسسات | غير محدودة |
وحين تُستنفَد الحصة، يعيد POST /esign/submissions رمز 403 مع الرمز الثابت
limit_reached:signatureRequests. أما سرد القوالب واستطلاع الحالة وتنزيل المستندات
الموقّعة فلا تُحتسَب أبدًا، والطلب المعاد بمفتاح idempotencyKey مستخدَم سابقًا لا
يُحتسَب مرة أخرى.
توليد مستند مملوء دون إرساله للتوقيع (وهو متاح في التطبيق) لا يُحتسَب من الحصة كذلك — فطلبات التوقيع وحدها هي التي تُحتسَب.