تخطي إلى المحتوى الرئيسي

مرجع API

رموز الأخطاء

رموز الأخطاء

تُرجع نقاط نهاية 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