الحدود والأخطاء

اقرأ كل صفحة، والتزم بحدود المعدل، واسترجع الأخطاء بأمان.

1. حدود المعدل

   الحدود قابلة للتكوين. يُبلغ GET و/v1/operations/capabilities عن requestsPerMinute وauthenticationRequestsPerMinutePerIp. بعد ظهور الخطأ 429، يتم تطبيق قاعدة إعادة المحاولة بعد ذلك، مع الانتظار لفترة أطول في حال استمرار التقييد. تقبل عمليات القراءة المجمعة ما يصل إلى 100 مُعرّف؛ وقد يكون لكل نقطة نهاية حدود أقل للصفحات أو الحمولة. (Retry-After)

2. اقرأ كل صفحة

   استخدم قاعدة المتابعة لنقطة النهاية التي استدعيتها، مع الحفاظ على نفس عوامل التصفية. قد تتغير القوائم أثناء قراءتها؛ استخدم اللقطات عندما تحتاج إلى نسخة متسقة.

   الترقيم	المتابعة مع	التوقف عند
   المؤشر	مرر next كـ after.	التالي هو null.
   إزاحة باستخدام nextOffset	تمرير nextOffset كـ offset.	nextOffset هو null.
   إزاحة باستخدام hasMore	زيادة الإزاحة بعدد العناصر المُعادة.	hasMore خطأ.
   البرنامج	مرر القيمة الرقمية next كـ after؛ أعد التشغيل إذا تغيرت updatedAtUtc.	التالي هو null.
   موجز الأحداث	مرر next كـ after.	hasMore خطأ.

3. معالجة الأخطاء

   اقرأ رمز الخطأ بالإضافة إلى حالة HTTP. إذا تضمنت الاستجابة requestId، فاذكرها عند الاتصال بالدعم.

   حالة HTTP	الإجراء المطلوب
   400	أصلح الطلب.
   401	تحقق من بيانات الاعتماد أو احصل على رمز وصول جديد.
   403	تحقق من النطاق والأذونات وما إذا كان الوصول مفعلاً.
   404	قد يكون المورد مفقودًا أو خارج نطاق صلاحياتك.
   409	اقرأ رمز الخطأ والحالة الحالية قبل اتخاذ القرار.
   410	انتهت صلاحية اللقطة أو مؤشر الحدث. ابدأ خط أساس جديد.

4. في حال انتهاء مهلة الكتابة

   لا يُعد انتهاء المهلة أو ظهور الخطأ 503 دليلًا على فشل العملية. بالنسبة لعمليات الكتابة التي تُرجع إيصالات، ابحث عن GET و/v1/operations/by-key?idempotencyKey={key} قبل إعادة المحاولة. لإنشاء الصيانة، أعد استخدام Idempotency-Key الأصلي والبيانات.