Skip to main content
GET
يُسنَد لكل مستخدم مشارك دور — تسمّي لوحة تحكم Scanova هذه داخليًا “مستويات الوصول” (access levels)، ويظهر المصطلح نفسه في نقطة النهاية هذه بأكملها. استخدم نقطة النهاية هذه للاطلاع على الأدوار المتاحة قبل دعوة زميل عبر POST /multi-users/، أو لإنشاء دور مخصص من أنظمتك الخاصة.
لم تكن نقطة النهاية هذه موثّقة سابقًا. تتطلب مفتاح Management API بحصة MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) — راجع نظرة عامة على Management API. لمعرفة ما يمنحه كل دور فعليًا لزميل، راجع دليل الأدوار والصلاحيات المُوجَّه للبشر — هذه الصفحة توثّق فقط الصيغة السلكية.
تم التحقق منه مباشرة: الحساب الجديد يعيد بالضبط هذه الأدوار الستة النظامية (Viewer، Analyst، Billing Manager، Manager، Admin، Full Access) — مطابقة لأداة الاختيار في الأدوار والصلاحيات الموجودة في درج Invite Users بلوحة التحكم. المعرّفات الموضحة أعلاه توضيحية فقط؛ مصفوفات الصلاحيات مختصرة للإيجاز في هذا المثال — الاستجابة الفعلية تتضمن كل صلاحية يمنحها الدور، كاملة.
النتائج مُرقّمة إلى صفحات (حجم الصفحة 10 افتراضيًا) ويمكن أن تتضمن أدوارًا مخصصة أنشأها الحساب، إلى جانب الأدوار النظامية الستة الافتراضية.
string
تصفية حسب system (الأدوار المدمجة، user تكون null فيها) أو custom (الأدوار التي أنشأها هذا الحساب).
مطابقة جزء نصي مقابل اسم الدور.
string
name أو -name.

حقول الاستجابة (لكل دور)

integer
معرّف الدور — مرّر هذه القيمة كـ access_level عند دعوة مستخدم مشارك أو تحديثه.
string
اسم عرض الدور، مثل Manager.
string | null
سلاج ثابت للأدوار النظامية (مثل managernull للأدوار المخصصة.
boolean
false للأدوار النظامية المدمجة الستة، وtrue لدور أنشأه هذا الحساب بنفسه.
array
كل صلاحية يمنحها هذا الدور.

ذات صلة

التفويضات

Authorization
string
header
مطلوب

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.

معلمات الاستعلام

type
enum<string>
الخيارات المتاحة:
system,
custom
ordering
string

الاستجابة

200 - application/json

Paginated list of roles, each with its permission set.