الهدف
إصدار رمز دخول (Sanctum) باسم جهاز معين عبر POST /api/v1/auth/login لاستخدامه في استدعاءات بوابة API.
الخطوات
- أرسل طلب POST إلى
/api/v1/auth/loginبالحقول:email،password، وdevice_name. - يتحقق النظام من البيانات ويُنشئ رمزاً بصلاحيات كاملة إن كان المستخدم SuperAdmin أو صلاحية
readلغيره. - تُعاد بيانات الرمز مع اسم المستخدم وبريده.
رسائل الخطأ
- 422 — البريد مطلوب وصيغته صحيحة، كلمة المرور مطلوبة، واسم الجهاز مطلوب حتى 255 حرفاً.
- 401 AUTH_INVALID_CREDENTIALS — "بيانات الدخول غير صحيحة" عند فشل المصادقة.
نصائح
استخدم اسماً وصفياً للجهاز (مثال: mobile-app) لتسهيل إدارة الرموز لاحقاً.
الأذونات
نقطة عامة تخضع لحد معدل الطلبات؛ تعتمد صلاحيات الرمز على دور المستخدم.