ما الذي يفشل، ومتى ينفرج، وكم يمكنك أن ترسل

يستخدم الإخفاق الغلاف نفسه الذي تستخدمه الاستجابة الناجحة، مع ok بقيمة false ورمز يحدّد ما الذي حدث.

{
  "ok": false,
  "statusCode": 429,
  "code": "ENTERPRISE_API_LIMIT_REACHED",
  "message": "…",
  "path": "/enterprise/v1/gis/buffer",
  "method": "POST",
  "timestamp": "2026-08-17T09:41:22.104Z"
}

الرموز أعلاه هي التي يُبنى عليها سلوك العميل. هذا الجدول مرجع لكل ما عداها، مجمّعًا حسب العائلة؛ والمعنى المعروض هو نص رسالة الواجهة نفسها. تعامل مع الرمز — فالرسائل مُعرّبة وقد تُعاد صياغتها.

رموز مجموعات البيانات وروابط المشاركة وغرف البيانات موثقة مع دليل مجموعات البيانات في ‎/docs/datasets.

• تقسّم النوافذ الزمن انطلاقًا من نقطة أصل ثابتة، بالطريقة نفسها لكل مؤسسة. فلا نقطة ارتكاز خاصة بكل عميل ولا انزياح مع تاريخ الاشتراك — وحدود النوافذ تقع في اللحظات نفسها لدى الجميع.
• الوحدة ملف واحد. فالتشغيل الذي يعالج عدة ملفات يستهلك عدة ملفات، والطلب الذي لا يحمل ملفًا إطلاقًا — أي إعادة الإسقاط بـ JSON — يُحتسب بملف واحد.
• الفحص مجموع على النافذة الحالية، ويتم قبل جدولة الأداة. فإذا كانت الملفات الواردة ستتجاوز السقف، أعاد الاستدعاء ENTERPRISE_API_LIMIT_REACHED ولم يُشغَّل شيء.
• لا يُسجَّل إلا التشغيل الناجح، فالاستدعاء المرفوض أو الفاشل لا يستهلك من النافذة.
• ولأن الحدود محدّدة سلفًا، يستطيع عميلك حساب موعد التجديد بنفسه: بدأت النافذة الحالية عند آخر مضاعف لـ 72 ساعة، وتتجدّد بعده بـ 72 ساعة بالضبط.

• يقبل الطلب المتزامن الواحد حتى 50 MB من المدخلات. وبعد ذلك يصبح الاتصال هو العنق لا المحرّك، وهذا ما وُجد المسار غير المتزامن لتجاوزه.
• يقبل العمل المُرسل كمهمة حتى 500 MB من المدخلات — الأدوات نفسها، لكنها تُنفَّذ خارج الطلب لا داخله.
• تبقى فرصة الرفع للمهمة مفتوحة 30 دقيقة. أكّد الرفع ضمن هذه المدة وإلا انتهت صلاحيتها وأُلغيت المهمة.

7حالات

تمرّ المهمة بمجموعة حالات ثابتة، من انتظار الرفع حتى النتيجة النهائية. وهذه الحالة هي المؤشّر الوحيد الموثوق على التقدّم — أما الزمن المنقضي فلا يدل على شيء منه.

8طوابير

يُوزَّع العمل على طوابير مخصّصة، فلا تنتظر مهمة معالجة جغرافية طويلة خلف أعمال منصة لا علاقة لها بها.

3محاولات

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

2,000ms تراجع

تنتظر إعادة المحاولة 2000 جزءًا من الألف من الثانية ثم تتراجع تصاعديًا. والعميل الذي يعيد المحاولة أسرع من ذلك يزيد الحمل ولا يحصل على جواب أبكر.

1. 01

   عند الالتقاط

   قبل أن يسحب العامل المهمة من الطابور أصلًا.

2. 02

   قبل حجز الحصة

   قبل أن يحجز التشغيل أي شيء على نافذة المؤسسة.

3. 03

   قبل استدعاء المحرّك

   بعد التهيئة، وقبل إرسال استدعاء المعالجة الجغرافية.

4. 04

   قبل تخزين المخرج

   بعد عودة المحرّك، وقبل كتابة النتيجة وتسجيلها.

الاستهلاك على النافذة الحالية — لكل عضو وأداة ومفتاح — معروض في لوحة تحكم مؤسستك.