Skip to main content
POST
يُسنَد لكل مستخدم مشارك دور — تسمّي لوحة تحكم Scanova هذه داخليًا “مستويات الوصول” (access levels)، ويظهر المصطلح نفسه في نقطة النهاية هذه بأكملها. استخدم نقطة النهاية هذه للاطلاع على الأدوار المتاحة قبل دعوة زميل عبر POST /multi-users/، أو لإنشاء دور مخصص من أنظمتك الخاصة.
لم تكن نقطة النهاية هذه موثّقة سابقًا. تتطلب مفتاح Management API بحصة MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) — راجع نظرة عامة على Management API. لمعرفة ما يمنحه كل دور فعليًا لزميل، راجع دليل الأدوار والصلاحيات المُوجَّه للبشر — هذه الصفحة توثّق فقط الصيغة السلكية.
إنشاء أدوار مخصصة يتطلب حصة مخصصة على خطة الحساب (نفس الحاجز الذي يُخفي علامة تبويب Roles في لوحة التحكم على الخطط غير المدعومة — راجع الأدوار المخصصة محكومة بالخطة). الرمز 403 هنا يعني أن الخطة لا تتضمنها.
string
مطلوب
اسم الدور. يجب أن يكون فريدًا بين أدوار هذا الحساب — التكرار يعيد 400 مع {"name": ["Can not create another user role with the same name."]}.
array
مطلوب
معرّفات الصلاحيات المراد منحها، من قيم permissions[].id في استجابة السرد أعلاه.
لا توجد نقطة نهاية جماعية “لسرد كل الصلاحيات المتاحة بمعزل عن أي دور” في Management API — لاكتشاف معرّفات الصلاحيات، اقرأها من مصفوفة permissions الخاصة بدور موجود مسبقًا (كل حساب لديه على الأقل الأدوار النظامية الستة لفحصها).

ذات صلة

التفويضات

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.

الجسم

application/json
name
string
مطلوب
permissions
integer[]
مطلوب

Permission IDs from an existing role's permissions[].id values.

الاستجابة

201 - application/json

Custom role created. Requires the account's custom-roles plan quota.