المراجع واستكشاف الأخطاء

رموز الأخطاء واستكشاف الأخطاء

View as Markdown

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

1{
2  "code": 1003,
3  "message": "Invalid token",
4  "requestId": "req-12345678"
5}

عادة ما تعيد أخطاء الأعمال هيكل JSON الموحد. يجب على المدمجين التحقق من code أولا. قد تعيد حالات فشل المصادقة HTTP 401؛ قد تعيد حدود المعدل HTTP 429.

رموز الأخطاء الشائعة

رمز الخطأالوصف
0النجاح
1001لم يتم تقديم معلومات مصادقة صحيحة
1002الرمز منتهية صلاحيته
1003رمز غير صالح، API Keyأو توقيع
1004تم سحب الرمز
1006المصدر IP عدم التطابق
2001المعلمة المطلوبة مفقودة
2002قيمة المعلمة غير صالحة
2003المعامل خارج النطاق
3001التوازن غير الكافي
3003لم يتم العثور على الترتيب
3004طلب مكرر
3005لا يمكن إلغاء الطلب
3006تم رفض الإذن
3100 - 3112خطأ التحقق من صحة معلمات ترتيب الشروط
5001خطأ داخلي في الخادم
5002الخدمة غير متاحة مؤقتا
5003تفعيل حد السعر

استكشاف الأخطاء

المشكلةالتوصية
1001 لا توجد معلومات مصادقة صالحةتحقق مما إذا كان Authorization: Bearer <accessToken> أو X-API-KEY متضمن.
1002 الرمز منتهي صلاحيتهقم بتحديث الرمز أو تسجيل الدخول مرة أخرى قبل إعادة المحاولة.
1003 رمز غير صالح أو API Keyأو توقيعتحقق من API Key، حمولة التوقيع، نص JSON نص الطلب، وترتيب معلمات الاستعلام.
المصدر 1006 IP عدم تطابقتحقق من إعدادات القائمة البيضاء API Key IP .
3004 طلب مكررلا تعيد استخدام نفس التوقيع في المسارات المتعلقة بالترتيب. أعد توليد timestamp signature.
5003 حد السعر تم تفعيلهقلل من تكرار الطلبات واستخدم التراجع الأسي عند إعادة المحاولة.
Timestamp outside of tolerance windowاتصل /v1/time لمعايرة تعويض الوقت وتوقيع الطلب مرة أخرى.