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

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

تعامل مع أعطال WebSocket عبر غلاف خطأ موحد. استخدم رمز الإغلاق لتصنيف الخطأ، وأحدث error.code/details لتحديد الإجراء المناسب.

رموز أخطاء WebSocket

WS_INTERNAL_ERROR4000

أوقف عطل داخلي في الاتصال عملية الإعداد.

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

WS_AUTH_OR_ACCESS4401 / 4403MARKET_DATA_ENTITLEMENT_*

تمنع مشكلة في وصول الحساب أو صلاحياته الوصول إلى البث.

الإجراء: يعني 4401 تصحيح مصادقة مفتاح API، ويعني 4403 تصحيح صلاحية الحساب أو الباقة. لا تُعِد الاتصال تلقائياً.

WS_RATE_LIMIT4429DEPTH_WS_*_LIMIT / *_RATE_LIMITED

تم تجاوز حدود الاتصال أو الاشتراك أو الإجراءات.

الإجراء: أعد المحاولة بتراجع وتأخير عشوائي، والتزم بقيمة retry_after_seconds في أحدث تفاصيل الخطأ عند توفرها.

WS_INVALID_REQUESTINVALID_JSON / UNKNOWN_ACTION / SYMBOL_REQUIRED and lowercase variants

حمولة غير صالحة أو إجراء غير مدعوم.

الإجراء: الرموز خاصة بكل قناة وحساسة لحالة الأحرف. صحح الحمولة وأعد الإجراء؛ ويبقى الاتصال مفتوحاً عادةً.

ضوابط تعدد الاتصالات

  • افتح الاتصالات بفاصل 200–400 مللي ثانية بدلاً من تشغيلها دفعة واحدة.
  • ضع محاولات إعادة الاتصال في طابور موحد لكل مفتاح API.
  • تجنب عواصف إعادة الاتصال المتزامنة عند افتتاح السوق.

الاتصال خارج ساعات التداول

يمكنك إبقاء اتصالات WebSocket مفتوحة خارج ساعات السوق. لا تقطع سهمك اتصالات العملاء عمداً عند إغلاق السوق. واصل إرسال ping كل 30 ثانية، وأعد الاتصال عند الحاجة بتراجع أسي محدود وتأخير عشوائي، ثم استعد الاشتراكات بعد كل اتصال. قد لا تصل أحداث سوق عندما يكون السوق غير نشط.

غلاف الخطأ

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

آخر تحديث في