تعرض الآن: رموز الأخطاء

التنبيهات وWebhooks - رموز الأخطاء

تعامل مع فشل تسليم webhooks باستخدام مستهلكين آمنين لإعادة المحاولة ومطابقة واضحة للحالات.

إرشادات تشغيلية

  • تعامل مع محاولات التسليم بوصفها قابلة للتكرار الآمن؛ فقد يتكرر التسليم عند إعادة المحاولة.
  • أعد 2xx سريعاً بعد الحفظ الدائم، وعالج الأعمال الثقيلة بشكل غير متزامن.
  • تتبع معرفات التسليم وأسباب الفشل للدعم والمطابقة.
400INVALID_PARAM

حقل حمولة غير صالح أو خيار استعلام غير مدعوم.

الإجراء: صحح حمولة الطلب وأعد المحاولة.

401AUTH_REQUIRED

ترويسة X-API-Key مفقودة.

الإجراء: أضف مفتاح API نشطاً وأعد المحاولة.

403PLAN_LIMIT / FEATURE_DISABLED

لا تملك الباقة صلاحية الميزة أو تم بلوغ الحدود.

الإجراء: رقِّ الباقة أو عدّل الاستخدام.

404NOT_FOUND

لم يتم العثور على مورد webhook أو التنبيه لهذا الحساب.

الإجراء: تحقق من معرف المورد وسياق الملكية.

429detail

تم بلوغ حد الاندفاع أو الحصة؛ التزم بـRetry-After عند توفره.

الإجراء: تراجع وأعد المحاولة مع تأخير عشوائي.

صيغة استجابة الخطأ

json
{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable message"
  }
}

أخطاء WebSocket اللحظية

لرموز إغلاق WebSocket وسلوك إعادة الاتصال وإرشادات المعالجة، راجع WebSocket اللحظي - الأخطاء.

آخر تحديث في