المستخدمون

للمسؤولين

المستخدمون هم حسابات الموظفين في مساحة عملك: من يسجّلون الدخول إلى التطبيق. استخدم هذه القائمة (للقراءة فقط) لربط لجان المقابلات ومنفّذي أحداث التدقيق بالأشخاص في دليلك. لا تُسرد حسابات بوابات المرشحين والموظفين والمدربين.

جميع النقاط تحت /api/v1 وتتطلب مفتاح واجهة برمجية (Authorization: Bearer jdr_live_…) ينشئه مسؤول مساحة العمل من الإعدادات ← التكاملات.

النقاط

الطريقة والمسار	ما تفعله	الصلاحية
`GET /api/v1/users`	سرد مستخدمي الموظفين (ترقيم بالمؤشر، `updatedSince`، `?roleId=`)	`users.view`

المستخدمون للقراءة فقط عبر الواجهة البرمجية. تتم الدعوة وتغيير الأدوار والإزالة من الإعدادات ← المستخدمون.

كائن المستخدم

الحقل	النوع	ملاحظات
`id`	نص	يُستخدم في `interviewerIds` وكمعرّف منفّذ الحدث في التدقيق.
`fullName`	نص
`email`	نص	بريد تسجيل الدخول.
`role`	كائن أو null	`{ id, name: { ar, en }, isWorkspaceAdmin }`، انظر الأدوار. null لحساب موظف بلا دور بعد.
`status`	نص	`active` أو `disabled` (لا يستطيع الدخول).
`disabledAt`	ISO 8601 أو null
`locale`	نص	`ar` أو `en`.
`personId`	نص أو null	سجل الموظف الخاص بالمستخدم، إن كان مرتبطاً.
`createdAt`، `updatedAt`	ISO 8601

لا تُعاد أبداً كلمات المرور ورموز الدخول وإعدادات التحقق الثنائي (MFA) وبيانات الجلسات.

يعيد updatedSince المستخدمين المُنشئين أو المعدَّلين منذ ذلك الوقت (ويُحتسب تغيير الدور). ويُسرد المستخدمون المُزالون في سجل المحذوفات (GET /api/v1/deleted). وتظهر الدعوات وبقية إجراءات الحسابات في سجل التدقيق (users.user.* وusers.invitation.*).

أحداث خطافات الويب

الحدث	متى	`data.object`
`user.updated`	تغيير دور المستخدم (`changedFields: ["role"]`)، أو تعطيل الحساب أو إعادة تفعيله (`changedFields: ["status", "disabledAt"]`)	المستخدم
`user.deleted`	إزالة حساب موظف	`{ id, externalRefs: [] }`

تُرسل هذه الأحداث سواء أُجري التغيير من إعدادات المستخدمين والأدوار في مساحة عملك أو أجراه فريق دعم جديرون من لوحة تحكم المنصة (تعطيل الحساب وإعادة تفعيله متاحان من لوحة التحكم فقط).

لا ترسل الدعوات أي حدث: يظهر المستخدم عند قبول الدعوة.

الأخطاء

الحالة والرمز	المعنى
`403 forbidden`	المفتاح لا يملك `users.view`.
`422 validation_failed`	قيمة غير صالحة لـ `limit` أو `cursor` أو `updatedSince`.

مثال

curl https://jadiroon.com/api/v1/users -H "Authorization: Bearer $JADIROON_KEY"

{
  "data": [
    {
      "id": "cmvikf7xk0003knoqj7x054vw",
      "fullName": "سارة الحربي",
      "email": "sara@example.com",
      "role": { "id": "cmviqdaf8004lknffw1rpf3ww", "name": { "ar": "مدير مساحة العمل", "en": "Workspace Admin" }, "isWorkspaceAdmin": true },
      "status": "active",
      "disabledAt": null,
      "locale": "ar",
      "personId": null,
      "createdAt": "2026-10-21T20:29:16.137Z",
      "updatedAt": "2026-10-24T10:02:11.420Z"
    }
  ],
  "nextCursor": null
}

← السابق

سلالم الرواتب

الأدوار