Lister les portées
curl --request GET \
--url https://api.truthlocks.com/v1/scopes \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/scopes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/scopes"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/scopes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "<string>",
"resource": "<string>",
"action": "<string>",
"display_name": "<string>",
"description": "<string>",
"category": "<string>",
"is_builtin": true,
"created_at": "2023-11-07T05:31:56Z"
}
]{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Sessions et outils d'agent
Lister les portées
Lister toutes les portées de permission disponibles, y compris les intégrations de plateforme et les portées personnalisées du locataire
GET
/
v1
/
scopes
Lister les portées
curl --request GET \
--url https://api.truthlocks.com/v1/scopes \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/scopes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/scopes"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/scopes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scope": "<string>",
"resource": "<string>",
"action": "<string>",
"display_name": "<string>",
"description": "<string>",
"category": "<string>",
"is_builtin": true,
"created_at": "2023-11-07T05:31:56Z"
}
]{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}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êteX-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.UUID du locataire propriétaire de cette étendue.
null pour les étendues intégrées au niveau de la plateforme
portées.La chaîne de portée complète au format
resource:action (par exemple, "data:read",
"model:train").true pour les portées définies par la plateforme, false pour les portées personnalisées créées par le locataire.Exemple
curl -G https://api.truthlocks.com/v1/scopes \
-H "X-API-Key: tl_live_..." \
-d "category=data"
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 :| Catégorie | Portées | Description |
|---|---|---|
data | read, write, delete, * | Accès aux ressources de données |
model | train, evaluate, deploy, attest, * | Cycle de vie du modèle ML |
tool | search.web, search.db, execute, * | Invocation d’outil |
agent | delegate, manage, inspect, * | Gestion du cycle de vie de l’agent |
admin | config, audit, billing, * | Opérations administratives |
receipt | create, verify, revoke, * | Gestion des reçus |
Référence du format de portée
resource:action Standard scope (e.g., "data:read")
resource:* Wildcard scope (e.g., "data:*" grants all data actions)
!resource:action Negation scope (e.g., "!data:delete" explicitly denies)
resource:sub.action Dotted sub-actions (e.g., "tool:search.web")

