رموز الأخطاء (Error Codes)

إذا واجهت الـ API مشكلة، ستعيد كائن JSON يحتوي على تفاصيل الخطأ. تحقق دائماً من الحقل status في الاستجابة. إذا كانت قيمته false، تحقق من الحقلين errno و errmsg لمزيد من المعلومات.

مثال على استجابة خطأ (Example Error Response)

{
  "status": false,
  "errno": 94,
  "errmsg": "invalid or missing key"
}

رموز الأخطاء (Error Codes)

errno errmsg الوصف
50 access denied عنوان IP أو Referer غير مصرح به. يرجى مراجعة صلاحيات الوصول الخاصة بك.
90 invalid country code تحقق من رموز الدول المدعومة. ISO 3166-1 alpha-2
91 name not set || email not set || username not set مفقود معلمة الاسم أو البريد الإلكتروني أو اسم المستخدم في طلبك.
92 too many names || too many emails || too many usernames الحد الأقصى هو 100 للأسماء، 50 للبريد الإلكتروني، و50 لأسماء المستخدمين في كل طلب.
93 limit reached تم استنفاد رصيد مفتاح الـ API.
94 invalid or missing key تعذر العثور على مفتاح الـ API.
99 API key has expired يرجى تجديد مفتاح الـ API الخاص بك.
نصيحة: تحقق دائماً من الحقل status في استجابة الـ API. إذا كانت قيمته false، راجع الحقلين errno و errmsg لمعرفة تفاصيل المشكلة.