الانتقال إلى المحتوى الرئيسي
GET
سرد النطاقات

قائمة النطاقات

GET /v1/scopes يعرض جميع نطاقات الأذونات المتاحة للمستأجر المصادق عليه. يتضمن ذلك النطاقات المضمنة المحددة بواسطة النظام الأساسي وأي نطاقات مخصصة أنشأها المستأجر. تتبع النطاقات تنسيق resource:action المحدد بواسطة بروتوكول MAIP.

المصادقة

يتطلب رأس X-API-Key أو رمز Bearer JWT. يتم اشتقاق مساحة العمل من بيانات الاعتماد الموثقة؛ لا ترسل X-Tenant-ID.

الاستجابة

يعرض مصفوفة من كائنات تعريف النطاق.
string
معرف UUID لتعريف النطاق.
string
معرف UUID للمستأجر الذي يمتلك هذا النطاق. null للمدمج على مستوى المنصة النطاقات.
string
سلسلة النطاق الكاملة بتنسيق resource:action (على سبيل المثال، "data:read"، "model:train").
string
مكون المورد للنطاق (على سبيل المثال، "data"، "model"، "tool").
string
مكون الإجراء للنطاق (مثل، "read"، "write"، "*").
string
اسم النطاق المقروء بشريًا.
string
وصف تفصيلي لما يمنحه النطاق من وصول.
string
فئة النطاق لأغراض تنظيمية.
boolean
true للنطاقات المعرفة بواسطة المنصة، false للنطاقات المخصصة التي أنشأها المستأجر.
string
طابع زمني لإنشاء ISO 8601.

مثال


فئات النطاق المضمنة

توفر المنصة أكثر من 25 نطاقًا مدمجًا عبر 6 فئات:

مرجع تنسيق النطاق

التفويضات

X-API-Key
string
header
مطلوب

مفتاح API للمصادقة من جهاز إلى جهاز

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

category
enum<string>

تصفية النطاقات حسب الفئة

الخيارات المتاحة:
data,
model,
tool,
agent,
admin,
receipt,
custom

الاستجابة

النطاقات المتاحة

id
string<uuid>
tenant_id
string<uuid> | null
scope
string
resource
string
action
string
display_name
string
description
string
category
string
is_builtin
boolean
created_at
string<date-time>