API di Amministrazione
L’API di Amministrazione ti permette di gestire programmaticamente le risorse della tua organizzazione, inclusi i membri dell’organizzazione, gli spazi di lavoro e le chiavi API. Questo fornisce un controllo programmatico sui compiti amministrativi che altrimenti richiederebbero una configurazione manuale nella Anthropic Console.
L’API di Amministrazione richiede un accesso speciale
L’API di Amministrazione richiede una chiave API di Amministrazione speciale (che inizia con sk-ant-admin...
) che differisce dalle chiavi API standard. Solo i membri dell’organizzazione con ruolo di amministratore possono fornire chiavi API di Amministrazione attraverso la Anthropic Console.
Come funziona l’API di Amministrazione
Quando usi l’API di Amministrazione:
- Effettui richieste usando la tua chiave API di Amministrazione nell’header
x-api-key
- L’API ti permette di gestire:
- Membri dell’organizzazione e i loro ruoli
- Inviti ai membri dell’organizzazione
- Spazi di lavoro e i loro membri
- Chiavi API
Questo è utile per:
- Automatizzare l’onboarding/offboarding degli utenti
- Gestire programmaticamente l’accesso agli spazi di lavoro
- Monitorare e gestire l’utilizzo delle chiavi API
Ruoli e permessi dell’organizzazione
Ci sono quattro ruoli a livello di organizzazione.
Ruolo | Permessi |
---|---|
user | Può usare Workbench |
developer | Può usare Workbench e gestire le chiavi API |
billing | Può usare Workbench e gestire i dettagli di fatturazione |
admin | Può fare tutto quanto sopra, più gestire gli utenti |
Concetti chiave
Membri dell’Organizzazione
Puoi elencare i membri dell’organizzazione, aggiornare i ruoli dei membri e rimuovere membri.
Inviti dell’Organizzazione
Puoi invitare utenti alle organizzazioni e gestire questi inviti.
Spazi di lavoro
Crea e gestisci spazi di lavoro per organizzare le tue risorse:
Membri degli Spazi di Lavoro
Gestisci l’accesso degli utenti a specifici spazi di lavoro:
Chiavi API
Monitora e gestisci le chiavi API:
Migliori pratiche
Per utilizzare efficacemente l’API di Amministrazione:
- Usa nomi e descrizioni significativi per gli spazi di lavoro e le chiavi API
- Implementa una corretta gestione degli errori per le operazioni fallite
- Controlla regolarmente i ruoli e i permessi dei membri
- Pulisci gli spazi di lavoro inutilizzati e gli inviti scaduti
- Monitora l’utilizzo delle chiavi API e ruotale periodicamente