سرد الأذونات
المفردات كاملة، مع الجملة والعنوان الذي يُعرض تحته كل مدخل.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
GET /roles/permissions
المفردات كاملة، مع الجملة والعنوان الذي يُعرض تحته كل مدخل.
مثال
يتطلب roles:read. ثابت، والإجابة نفسها لكل مساحة عمل، وهي القائمة التي تبني منها مصفوفة بدل نسخها إلى شيفرتك.
curl "$OE/roles/permissions" -H "$AUTH"{ "object": "list", "data": [ { "object": "permission", "id": "emails:send", "label": "Send email", "group": "mail", "scope": true }, { "object": "permission", "id": "members:write", "label": "Add and remove people, and change what they can reach", "group": "people", "scope": true }, { "object": "permission", "id": "api-keys:write", "label": "Create and revoke API keys", "group": "developer", "scope": false }, { "object": "permission", "id": "workspace:manage", "label": "Rename the workspace, remove domains and delete it", "group": "workspace", "scope": false } ]}مسجَّلة قبل /roles/{id}، وإلا قُرئت permissions كمعرّف دور وأجاب كل طلب إليها بـ 404. و/rules/runs تحمل الملاحظة نفسها فوقها و/tracking/stats فوق تلك، وكلاهما كُتب بعد الخطأ نفسه. ولذلك فإن طلب دور اسمه فعلًا «permissions» يطلب دورًا ويحصل على 404، وهي الإجابة الصادقة عمّا كُتب.
scope تقول هل يُسمح لمفتاح API بحمل الإذن أصلًا. خمسة لا يمكنها ذلك (api-keys:read وapi-keys:write وbilling:read وbilling:write وworkspace:manage) لأنه لا توجد نقطة نهاية لأي منها ولأن المفتاح ليس شخصًا. وتلك الراية هي ما يتيح لمكوّن واحد أن يرسم مصفوفة الأدوار وقائمة مربعات إنشاء المفتاح معًا، بدل نسخة ثانية تُصان يدويًا لتحديد أيهما أيّ.
تُقدَّم بدل أن تُنسَخ، للسبب نفسه الذي تعطيه قائمة حقول القواعد: فالمصفوفة المبنية من مصفوفة منسوخة تظل تعرض إذنًا يوم إعادة تسميته ولا تعرض أبدًا الإذن الذي أُضيف الأسبوع الماضي. وgroup هو العنوان الذي تُعرض تحته ويسقط إلى other بدل أن تخرج غير معرَّفة. فالإذن الذي لا يستطيع أحد رؤيته هو إذن لا يدققه أحد.
الترتيب معياري: فهو الترتيب الذي تعود به مصفوفة permissions لدور مخزَّن، فالعميل الذي يرسم هذه القائمة والعميل الذي يرسم دورًا يعرضان الأذونات نفسها بالتسلسل نفسه.
لا غلاف أبعد من object وdata. فالمفردات مغلقة وقصيرة، فلا cursor ولا hasMore، بخلاف كل قائمة أخرى في الـ API.