تسجيل الدخول عبر API

الهدف

تسجيل الدخول بالبريد الإلكتروني وكلمة المرور عبر POST /api/v1/login للحصول على رمز دخول جديد.

الخطوات

1. أرسل طلب POST إلى /api/v1/login بحقلي email وpassword.
2. يتحقق النظام من البيانات عبر حارس المصادقة.
3. عند النجاح يُنشأ رمز api-token وتُعاد بيانات المستخدم مع الرمز.

رسائل الخطأ

• 422 — البريد مطلوب وصيغته صحيحة، وكلمة المرور مطلوبة.
• 401 AUTH_INVALID_CREDENTIALS — "بيانات الدخول غير صحيحة" إذا لم تتطابق البيانات.

نصائح

أرسل الرمز في ترويسة Authorization: Bearer <token> للطلبات اللاحقة.

الأذونات

نقطة عامة؛ تخضع لحد معدل الطلبات (throttle).