الأخطاء والحدود وترقيم النتائج
تعامل مع حالة الاستجابة وسلوك القوائم والحدود الخاص بكل نقطة.
تشخيص الاستجابة
اقرأ حالة HTTP مع نص الخطأ الفعلي ولا تعتبر الحالة العامة تشخيصاً كاملاً.
| الحالة | ما يجب فحصه |
|---|---|
| 400 | حقول خاطئة أو معرّفات خارجية ناقصة أو حدث غير مدعوم |
| 401 | مفتاح أو توقيع مفقود أو خاطئ أو بيانات أو وقت منتهٍ |
| 403 | صلاحية النشاط أو تكامل غائب أو غير نشط أو ميزة غير متاحة |
| 404 | سجل نشاط خاطئ أو منتج أو متغير خارجي مجهول |
| 429 | تقييد الطلبات؛ أبطئ العميل واحترم Retry-After عند إعادته |
| 5xx | خطأ خادم أو مزوّد؛ افحص الأثر قبل تكرار الكتابة |
حدود الطلبات
يهيّئ الخادم المفحوص افتراضياً 10 طلبات في الثانية و50 خلال 10 ثوانٍ و200 في الدقيقة. هذه قيم المصدر وليست حصص خطط أو ضماناً لكل مسار منشور. قد تختلف الاستثناءات والوكيل وحدود المزوّد. افحص الاستجابة واستخدم تراجعاً محدوداً ولا تكرر الكتابة عشوائياً عند نتيجة ملتبسة.
الترقيم خاص بالنقطة
لا تُرقّم طلبات تهيئة ومزامنة المنتجات الخارجية. تقبل قائمة تسليم Webhook الإدارية limit وoffset وفلتر event الاختياري في:
GET /api/v1/businesses/:businessId/integrations/:integrationId/webhooks/:webhookId/deliveries
?limit=20&offset=0
هذا مسار إدارة مصادق وليس تصريحاً بإمكان قراءته بمفتاح منتجات خارجي. قد تستخدم صناديق أخرى page وlimit وhasMore. لا تعمم عقد قائمة على نقطة أخرى.
النتائج الجزئية والاستعادة
تعيد التهيئة فشلاً لكل سجل حتى عند نجاح الطلب. افحص failed وصحح السجلات وتحقق من الكتالوج قبل الإعادة. لفشل النقل افحص التسليمات ومرجع التوقيع والتسليم. لا تسجل الأسرار أو محتوى العميل غير اللازم.
النتيجة المتوقعة
يحافظ العميل على الخطأ الفعلي ويتبع عقد القائمة الصحيح ويتجنب تكرار الإجراءات أثناء الاستعادة.