curl --request GET \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 6,
"next": null,
"previous": null,
"results": [
{
"id": 3,
"name": "Viewer",
"slug": "viewer",
"permissions": [
{
"id": 23,
"code": "QR_CODE_CAN_VIEW",
"name": "Can view QR Code",
"description": "Allows viewing QR code details.",
"is_boolean": true
}
],
"is_custom": false
},
{
"id": 4,
"name": "Analyst",
"slug": "analyst",
"permissions": ["..."],
"is_custom": false
},
{
"id": 5,
"name": "Billing Manager",
"slug": "billing-manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 6,
"name": "Manager",
"slug": "manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 7,
"name": "Admin",
"slug": "admin",
"permissions": ["..."],
"is_custom": false
},
{
"id": 8,
"name": "Full Access",
"slug": "full-access",
"permissions": ["..."],
"is_custom": false
}
]
}
واجهة الإدارة — المستخدمون المشتركون والأدوار
سرد الأدوار
GET /multi-users/access-levels/
GET
/
multi-users
/
access-levels
/
curl --request GET \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 6,
"next": null,
"previous": null,
"results": [
{
"id": 3,
"name": "Viewer",
"slug": "viewer",
"permissions": [
{
"id": 23,
"code": "QR_CODE_CAN_VIEW",
"name": "Can view QR Code",
"description": "Allows viewing QR code details.",
"is_boolean": true
}
],
"is_custom": false
},
{
"id": 4,
"name": "Analyst",
"slug": "analyst",
"permissions": ["..."],
"is_custom": false
},
{
"id": 5,
"name": "Billing Manager",
"slug": "billing-manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 6,
"name": "Manager",
"slug": "manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 7,
"name": "Admin",
"slug": "admin",
"permissions": ["..."],
"is_custom": false
},
{
"id": 8,
"name": "Full Access",
"slug": "full-access",
"permissions": ["..."],
"is_custom": false
}
]
}
يُسنَد لكل مستخدم مشارك دور — تسمّي لوحة تحكم Scanova هذه داخليًا “مستويات الوصول” (access levels)، ويظهر المصطلح نفسه في نقطة النهاية هذه بأكملها. استخدم نقطة النهاية هذه للاطلاع على الأدوار المتاحة قبل دعوة زميل عبر
النتائج مُرقّمة إلى صفحات (حجم الصفحة 10 افتراضيًا) ويمكن أن تتضمن أدوارًا مخصصة أنشأها الحساب، إلى جانب الأدوار النظامية الستة الافتراضية.
POST /multi-users/، أو لإنشاء دور مخصص من أنظمتك الخاصة.
لم تكن نقطة النهاية هذه موثّقة سابقًا. تتطلب مفتاح Management API بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) — راجع نظرة عامة على Management API. لمعرفة ما يمنحه كل دور فعليًا لزميل، راجع دليل الأدوار والصلاحيات المُوجَّه للبشر — هذه الصفحة توثّق فقط الصيغة السلكية.curl --request GET \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 6,
"next": null,
"previous": null,
"results": [
{
"id": 3,
"name": "Viewer",
"slug": "viewer",
"permissions": [
{
"id": 23,
"code": "QR_CODE_CAN_VIEW",
"name": "Can view QR Code",
"description": "Allows viewing QR code details.",
"is_boolean": true
}
],
"is_custom": false
},
{
"id": 4,
"name": "Analyst",
"slug": "analyst",
"permissions": ["..."],
"is_custom": false
},
{
"id": 5,
"name": "Billing Manager",
"slug": "billing-manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 6,
"name": "Manager",
"slug": "manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 7,
"name": "Admin",
"slug": "admin",
"permissions": ["..."],
"is_custom": false
},
{
"id": 8,
"name": "Full Access",
"slug": "full-access",
"permissions": ["..."],
"is_custom": false
}
]
}
تم التحقق منه مباشرة: الحساب الجديد يعيد بالضبط هذه الأدوار الستة النظامية (Viewer، Analyst، Billing Manager، Manager، Admin، Full Access) — مطابقة لأداة الاختيار في الأدوار والصلاحيات الموجودة في درج Invite Users بلوحة التحكم. المعرّفات الموضحة أعلاه توضيحية فقط؛ مصفوفات الصلاحيات مختصرة للإيجاز في هذا المثال — الاستجابة الفعلية تتضمن كل صلاحية يمنحها الدور، كاملة.
string
تصفية حسب
system (الأدوار المدمجة، user تكون null فيها) أو custom (الأدوار التي أنشأها هذا الحساب).string
مطابقة جزء نصي مقابل اسم الدور.
string
name أو -name.حقول الاستجابة (لكل دور)
integer
معرّف الدور — مرّر هذه القيمة كـ
access_level عند دعوة مستخدم مشارك أو تحديثه.string
اسم عرض الدور، مثل
Manager.string | null
سلاج ثابت للأدوار النظامية (مثل
manager)؛ null للأدوار المخصصة.boolean
false للأدوار النظامية المدمجة الستة، وtrue لدور أنشأه هذا الحساب بنفسه.array
كل صلاحية يمنحها هذا الدور.
ذات صلة
- إنشاء دور مخصص — العملية الأخرى لنفس نقطة النهاية هذه.
- دعوة مستخدم مشارك — أسند معرّف دور من هذه القائمة عند دعوة زميل أو تحديثه.
- تحديث مستخدم مشارك — أسند معرّف دور من هذه القائمة عند دعوة زميل أو تحديثه.
- الأدوار والصلاحيات — الشرح المُوجَّه للبشر لما يمنحه كل دور، بما في ذلك حاجز الخطة للأدوار المخصصة.
- المستخدمون المشاركون — جدول Users الخاص بلوحة التحكم حيث تُسنَد هذه الأدوار عبر الواجهة.
التفويضات
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.
الاستجابة
200 - application/json
Paginated list of roles, each with its permission set.
هل كانت هذه الصفحة مفيدة؟
⌘I