الهدف
إنشاء حساب جديد عبر POST /api/v1/register مع إسناد الدور المناسب وإنشاء ملف هيئة التدريس عند الحاجة، وإعادة رمز دخول (Sanctum) فوراً.
الخطوات
- أرسل طلب POST إلى
/api/v1/register. - أرسل الحقول:
name،email،password،role(Student, Faculty, Investor). - يتم ربط الحساب بالجامعة الحالية، وإنشاء ملف أستاذ عند اختيار دور Faculty.
- يُعاد الرد برمز الحالة 201 مع بيانات المستخدم ورمز الدخول
token.
رسائل الخطأ
- 422 — الاسم مطلوب (حتى 255 حرفاً)، البريد مطلوب وصيغته صحيحة وغير مسجل مسبقاً، كلمة المرور مطلوبة و8 أحرف على الأقل، الدور يجب أن يكون أحد القيم المسموحة.
- 404 "لا توجد جامعة مفعلة" — الجامعة المحددة غير موجودة أو لا توجد جامعة مفعلة.
نصائح
- عند اختيار دور الطالب أو الأستاذ يُبنى اسم الدور تلقائياً بصيغة
Role_universitySlug. - احفظ الرمز فوراً؛ فلن يُعرض مرة أخرى.
الأذونات
نقطة عامة؛ تخضع لحد معدل الطلبات (throttle).