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 Console Anthropic.

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 Console Anthropic.

Come funziona l’API di Amministrazione

Quando usi l’API di Amministrazione:

  1. Effettui richieste usando la tua chiave API di Amministrazione nell’header x-api-key
  2. 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.

RuoloPermessi
userPuò usare Workbench
developerPuò usare Workbench e gestire le chiavi API
billingPuò usare Workbench e gestire i dettagli di fatturazione
adminPuò 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

FAQ