الأخطاء ورموز الحالة وإعادة المحاولة

نظرة سريعة#

تردّ البوابة على أخطائها بجسم JSON فيه حقل message، ويحمل كل رد ترويسة X-Kong-Request-Id. أما الأخطاء الصادرة من خدمة المزوّد نفسها فتُمرَّر كما هي.

{
  "message": "No active subscription for this product"
}

ردود البوابة#

إعادة المحاولة بتباعد أسّي وعشوائية#

أعِد المحاولة للأعطال المؤقتة فقط (أخطاء الشبكة وردود 502 أو 503 أو 504)، ثلاث مرات على الأكثر، وبفاصل عشوائي. وإلا أعاد كل عملائك المحاولة في اللحظة نفسها فصنعوا موجة ثانية.

async function call(fn, tries = 3) {
  for (let i = 0; i < tries; i++) {
    const res = await fn();
    // retry temporary failures only: not an exhausted quota, not a missing subscription
    if (![502, 503, 504].includes(res.status) || i === tries - 1) return res;
    await new Promise((r) => setTimeout(r, 2 ** i * 1000 + Math.random() * 400));
  }
}

حين تحتاج الدعم#

أرسل قيمة X-Kong-Request-Id من الرد عند التواصل مع الدعم، ليُعثر على الاستدعاء (احصل على المساعدة).

انظر أيضاً#

• الحصص والاستهلاك
• المصادقة