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

مرجع API

المصادقة

المصادقة

يستخدم MenuGaze مصادقة قائمة على JWT. تتطلب جميع نقاط النهاية التي تستلزم المصادقة رمز Bearer صالحًا في الترويسة Authorization. ويتم الحصول على الرموز بتسجيل الدخول عبر نقاط نهاية المصادقة أدناه.

POST /api/auth/signup

إنشاء حساب جديد.

المصادقة: عامة (لا يلزم رمز)

حد المعدل: 10 طلبات لكل 15 دقيقة لكل عنوان IP

جسم الطلب

{
  "name": "Jane Smith",
  "email": "jane@example.com",
  "password": "securepassword123",
  "restaurantName": "Jane's Bistro"
}

الاستجابة (201 Created)

{
  "success": true,
  "data": {
    "user": {
      "id": "uuid",
      "name": "Jane Smith",
      "email": "jane@example.com"
    },
    "token": "eyJhbGciOiJIUzI1NiIs..."
  }
}

POST /api/auth/login

تسجيل الدخول بحساب موجود.

المصادقة: عامة (لا يلزم رمز)

حد المعدل: 10 طلبات لكل 15 دقيقة لكل عنوان IP

جسم الطلب

{
  "email": "jane@example.com",
  "password": "securepassword123"
}

الاستجابة (200 OK)

{
  "success": true,
  "data": {
    "user": {
      "id": "uuid",
      "name": "Jane Smith",
      "email": "jane@example.com"
    },
    "token": "eyJhbGciOiJIUzI1NiIs..."
  }
}

استخدام الرمز

ضمّن الرمز في الترويسة Authorization لجميع الطلبات التي تتطلب المصادقة:

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

استجابات الأخطاء

  • 400 — حقول مفقودة أو غير صالحة في جسم الطلب.
  • 401 — بريد إلكتروني أو كلمة مرور غير صالحة.
  • 429 — تم تجاوز حد المعدل. تحقق من الترويسة Retry-After لمعرفة عدد الثواني المتبقية قبل أن تتمكن من إعادة المحاولة.