Authentication Guide دليل المصادقة

EMTITHAL uses JWT Bearer tokens. All protected endpoints require an Authorization: Bearer <token> header.

تستخدم منصة إمتثال رموز JWT. جميع نقاط النهاية المحمية تتطلب الترويسة Authorization: Bearer <token>.

1. Register 1. التسجيل

Create a new account with an email and password. A verification email is sent automatically.

أنشئ حسابًا جديدًا بالبريد الإلكتروني وكلمة المرور. يُرسَل بريد التحقق تلقائيًا.

POST https://api.emtithal.aisc.sa/api/v1/auth/register
Content-Type: application/json

{
  "email": "engineer@example.sa",
  "password": "YourSecurePassword!"
}

2. Verify Email 2. التحقق من البريد

After registering, an OTP is emailed. Submit it to activate your account:

بعد التسجيل يُرسَل رمز OTP إلى بريدك. أرسله لتفعيل حسابك:

POST https://api.emtithal.aisc.sa/api/v1/auth/verify-email
Content-Type: application/json

{
  "email": "engineer@example.sa",
  "otp": "123456"
}

3. Login 3. تسجيل الدخول

Exchange credentials for a short-lived access token and a longer-lived refresh token:

استبدل بيانات الاعتماد بـرمز وصول قصير الأمد ورمز تجديد طويل الأمد:

POST https://api.emtithal.aisc.sa/api/v1/auth/login
Content-Type: application/json

{
  "email": "engineer@example.sa",
  "password": "YourSecurePassword!"
}

// Response:
{
  "access_token": "eyJhbGci...",
  "refresh_token": "eyJhbGci...",
  "token_type": "bearer",
  "expires_in": 900
}

4. Use the Token 4. استخدام الرمز

Add the Authorization header to every protected request:

أضف ترويسة Authorization إلى كل طلب محمي:

GET https://api.emtithal.aisc.sa/api/v1/auth/me
Authorization: Bearer eyJhbGci...
Accept-Language: ar

5. Refresh the Token 5. تجديد الرمز

Access tokens expire in 15 minutes. Use the refresh token to get a new pair without re-logging in:

تنتهي صلاحية رموز الوصول خلال 15 دقيقة. استخدم رمز التجديد للحصول على زوج جديد دون إعادة تسجيل الدخول:

POST https://api.emtithal.aisc.sa/api/v1/auth/refresh
Content-Type: application/json

{
  "refresh_token": "eyJhbGci..."
}

6. Logout 6. تسجيل الخروج

Invalidate all tokens for the current session:

إلغاء صلاحية جميع الرموز للجلسة الحالية:

POST https://api.emtithal.aisc.sa/api/v1/auth/logout
Authorization: Bearer eyJhbGci...

---

Error Handling معالجة الأخطاء

Auth errors return bilingual JSON envelopes. Common codes:

تُعيد أخطاء المصادقة غلافات JSON ثنائية اللغة. الرموز الشائعة:

Codeالرمز	HTTPHTTP	Meaning (EN)المعنى (EN)	Meaning (AR)المعنى (AR)
AUTH.INVALID_CREDENTIALS	401	Email or password is incorrect	البريد الإلكتروني أو كلمة المرور غير صحيحة
AUTH.EMAIL_NOT_VERIFIED	403	Email address must be verified before logging in	يجب التحقق من البريد الإلكتروني قبل تسجيل الدخول
AUTH.INVALID_TOKEN	401	Access token is invalid or expired	رمز الوصول غير صالح أو منتهي الصلاحية
AUTH.SESSION_EXPIRED	401	Your session has expired. Please log in again	انتهت جلستك. يرجى تسجيل الدخول من جديد
AUTH.MISSING_TOKEN	401	Authorization header with Bearer token is required	يجب إرسال رمز Bearer في ترويسة التفويض
AUTH.EMAIL_ALREADY_REGISTERED	409	An account with this email already exists	يوجد حساب مسجل بهذا البريد الإلكتروني

See all error codes →

انظر جميع رموز الأخطاء ←

---

Locale Header ترويسة اللغة

Send Accept-Language: ar or Accept-Language: en on any request. All error responses carry both languages in the bilingual envelope; this header controls which language is primary.

أرسل Accept-Language: ar أو Accept-Language: en في أي طلب. تحتوي جميع ردود الأخطاء على كلا اللغتين في الغلاف الثنائي؛ هذه الترويسة تتحكم في اللغة الأساسية.