Passer au contenu principal
GET
Lister les portées

Lister les portées

GET /v1/scopes Retourne toutes les portées de permission disponibles pour le locataire authentifié. Cela inclut les portées intégrées définies par la plateforme et toutes les portées personnalisées créées par le locataire. Les portées suivent le format resource:action défini par le protocole MAIP.

Authentification

Nécessite l’en-tête X-API-Key ou un jeton JWT Bearer. L’espace de travail est dérivé de l’identifiant authentifié ; n’envoyez pas X-Tenant-ID.

Réponse

Retourne un tableau d’objets de définition de portée.
string
UUID de la définition d’étendue.
string
UUID du locataire propriétaire de cette étendue. null pour les étendues intégrées au niveau de la plateforme portées.
string
La chaîne de portée complète au format resource:action (par exemple, "data:read", "model:train").
string
Le composant ressource de la portée (par exemple, "data", "model", "tool").
string
Le composant d’action de la portée (par exemple, "read", "write", "*").
string
Nom lisible par l’homme pour la portée.
string
Description détaillée de ce à quoi la portée donne accès.
string
Catégorie de portée à des fins organisationnelles.
boolean
true pour les portées définies par la plateforme, false pour les portées personnalisées créées par le locataire.
string
Horodatage de création ISO 8601.

Exemple


Catégories de portée intégrées

La plateforme offre plus de 25 portées intégrées réparties en 6 catégories :

Référence du format de portée

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Paramètres de requête

category
enum<string>

Filtrer les portées par catégorie

Options disponibles:
data,
model,
tool,
agent,
admin,
receipt,
custom

Réponse

Portées disponibles

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>