curl --request POST \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Regional Support",
"permissions": [23, 24, 31]
}'
{
"id": 42,
"name": "Regional Support",
"slug": null,
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true },
{ "id": 24, "code": "ANALYTICS_CAN_VIEW", "name": "Can view Analytics", "description": "Allows viewing analytics.", "is_boolean": true },
{ "id": 31, "code": "LEAD_GENERATION_CAN_VIEW", "name": "Can view Lead Lists", "description": "Allows viewing lead lists.", "is_boolean": true }
],
"is_custom": true
}
واجهة الإدارة — المستخدمون المشتركون والأدوار
إنشاء دور مخصص
POST /multi-users/access-levels/
POST
/
multi-users
/
access-levels
/
curl --request POST \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Regional Support",
"permissions": [23, 24, 31]
}'
{
"id": 42,
"name": "Regional Support",
"slug": null,
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true },
{ "id": 24, "code": "ANALYTICS_CAN_VIEW", "name": "Can view Analytics", "description": "Allows viewing analytics.", "is_boolean": true },
{ "id": 31, "code": "LEAD_GENERATION_CAN_VIEW", "name": "Can view Lead Lists", "description": "Allows viewing lead lists.", "is_boolean": true }
],
"is_custom": true
}
يُسنَد لكل مستخدم مشارك دور — تسمّي لوحة تحكم Scanova هذه داخليًا “مستويات الوصول” (access levels)، ويظهر المصطلح نفسه في نقطة النهاية هذه بأكملها. استخدم نقطة النهاية هذه للاطلاع على الأدوار المتاحة قبل دعوة زميل عبر
POST /multi-users/، أو لإنشاء دور مخصص من أنظمتك الخاصة.
لم تكن نقطة النهاية هذه موثّقة سابقًا. تتطلب مفتاح Management API بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) — راجع نظرة عامة على Management API. لمعرفة ما يمنحه كل دور فعليًا لزميل، راجع دليل الأدوار والصلاحيات المُوجَّه للبشر — هذه الصفحة توثّق فقط الصيغة السلكية.إنشاء أدوار مخصصة يتطلب حصة مخصصة على خطة الحساب (نفس الحاجز الذي يُخفي علامة تبويب Roles في لوحة التحكم على الخطط غير المدعومة — راجع الأدوار المخصصة محكومة بالخطة). الرمز 403 هنا يعني أن الخطة لا تتضمنها.
curl --request POST \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Regional Support",
"permissions": [23, 24, 31]
}'
{
"id": 42,
"name": "Regional Support",
"slug": null,
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true },
{ "id": 24, "code": "ANALYTICS_CAN_VIEW", "name": "Can view Analytics", "description": "Allows viewing analytics.", "is_boolean": true },
{ "id": 31, "code": "LEAD_GENERATION_CAN_VIEW", "name": "Can view Lead Lists", "description": "Allows viewing lead lists.", "is_boolean": true }
],
"is_custom": true
}
string
مطلوب
اسم الدور. يجب أن يكون فريدًا بين أدوار هذا الحساب — التكرار يعيد 400 مع
{"name": ["Can not create another user role with the same name."]}.array
مطلوب
معرّفات الصلاحيات المراد منحها، من قيم
permissions[].id في استجابة السرد أعلاه.لا توجد نقطة نهاية جماعية “لسرد كل الصلاحيات المتاحة بمعزل عن أي دور” في Management API — لاكتشاف معرّفات الصلاحيات، اقرأها من مصفوفة
permissions الخاصة بدور موجود مسبقًا (كل حساب لديه على الأقل الأدوار النظامية الستة لفحصها).ذات صلة
- سرد الأدوار — العملية الأخرى لنفس نقطة النهاية هذه.
- دعوة مستخدم مشارك — أسند معرّف دور من هذه القائمة عند دعوة زميل أو تحديثه.
- تحديث مستخدم مشارك — أسند معرّف دور من هذه القائمة عند دعوة زميل أو تحديثه.
- الأدوار والصلاحيات — الشرح المُوجَّه للبشر لما يمنحه كل دور، بما في ذلك حاجز الخطة للأدوار المخصصة.
- المستخدمون المشاركون — جدول 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.
الجسم
application/json
الاستجابة
201 - application/json
Custom role created. Requires the account's custom-roles plan quota.
هل كانت هذه الصفحة مفيدة؟
⌘I