رموز الأخطاء
تُرجع نقاط نهاية MenuGaze API رموز حالة HTTP القياسية. وتتضمن استجابات الأخطاء جسم JSON يحتوي على تفاصيل حول ما حدث من خطأ.
صيغة استجابة الخطأ
{
"success": false,
"error": "Human-readable error message"
}
رموز الحالة
| الرمز | المعنى | الأسباب الشائعة |
|---|---|---|
200 |
OK | نجح الطلب. يحتوي جسم الاستجابة على البيانات المطلوبة. |
201 |
Created | تم إنشاء المورد بنجاح. تُرجعه نقاط نهاية POST عند النجاح. |
400 |
Bad Request | حقول مفقودة أو غير صالحة في جسم الطلب. تحقق من وجود جميع الحقول المطلوبة وتنسيقها بشكل صحيح. |
401 |
Unauthorized | رمز مصادقة مفقود أو غير صالح. تأكد من تضمين رمز Bearer صالح في الترويسة Authorization. ربما انتهت صلاحية الرمز — سجّل الدخول مرة أخرى للحصول على رمز جديد. |
403 |
Forbidden | تمت مصادقتك لكن ليس لديك إذن للوصول إلى هذا المورد. ويعني هذا عادةً أنك تحاول الوصول إلى مورد تابع لمطعم آخر أو تعديله. |
404 |
Not Found | المورد المطلوب غير موجود. تحقق من صحة المعرّف في مسار الرابط. |
429 |
Too Many Requests | تم تجاوز حد المعدل. تحقق من الترويسة Retry-After لمعرفة عدد الثواني التي يجب انتظارها قبل إعادة المحاولة. تقتصر نقاط نهاية المصادقة على 10 طلبات لكل 15 دقيقة لكل عنوان IP. ويقتصر إنشاء الطلبات على 5 طلبات في الدقيقة لكل عنوان IP. |
500 |
Internal Server Error | حدث خطأ غير متوقع على الخادم. إذا استمر ذلك، فاتصل بالدعم. تُسجَّل هذه الأخطاء تلقائيًا للتحقيق فيها. |
503 |
Service Unavailable | الخدمة غير متاحة مؤقتًا. قد يحدث ذلك أثناء الصيانة أو عندما تكون خدمة خارجية مطلوبة (مثل السر الخاص بالعامل) غير مضبوطة. أعد المحاولة بعد فترة قصيرة. |
تحديد المعدل
تُرجع نقاط النهاية الخاضعة لحدود المعدل الحالة 429 عند تجاوز
الحد. وتتضمن الاستجابة:
-
الترويسة
Retry-After— عدد الثواني التي يجب انتظارها قبل إرسال طلب آخر. - رسالة خطأ تشير إلى حد المعدل الذي تم تجاوزه.
تُطبَّق حدود المعدل لكل عنوان IP. الحدود الحالية:
| نقطة النهاية | الحد |
|---|---|
| تسجيل الدخول والتسجيل | 10 طلبات لكل 15 دقيقة لكل عنوان IP |
| إنشاء الطلبات | 5 طلبات في الدقيقة لكل عنوان IP |
| العناصر ذات الصلة | 30 طلبًا في الدقيقة لكل عنوان IP |