Vai al contenuto principale
L’API v3 offre supporto RBAC completo con autenticazione degli utenti di servizio. Questa è l’API consigliata per l’automazione in produzione.
L’API v3 è attualmente in beta. Alcuni endpoint potrebbero cambiare man mano che miglioriamo l’API.
URL di base:
  • https://api.devin.ai/v3beta1/enterprise/* – endpoint che richiedono autorizzazioni Enterprise (a livello di account)
  • https://api.devin.ai/v3beta1/organizations/* – endpoint con ambito limitato a una singola organizzazione
Autenticazione: Credenziali utente di servizio (a livello Enterprise o di organizzazione) (scopri di più)
Alcuni endpoint Enterprise operano su organizzazioni specifiche ma sono comunque protetti da autorizzazioni a livello Enterprise. Utilizzano percorsi come /v3beta1/enterprise/organizations/{org_id}/... (ad esempio, GET /v3beta1/enterprise/organizations/{org_id}/audit-logs). Anche se includono un parametro di percorso org_id, richiedono comunque autorizzazioni a livello Enterprise come ManageEnterpriseSettings.

​
Autorizzazioni e RBAC

L’API v3 utilizza il controllo degli accessi basato sui ruoli (RBAC) con utenti di servizio. Ogni endpoint richiede autorizzazioni specifiche assegnate al ruolo dell’utente di servizio. Gli utenti di servizio possono essere creati sia a livello Enterprise che a livello di organizzazione e le loro autorizzazioni determinano a quali endpoint possono accedere.

​
Tipi di autorizzazione

L’API v3 utilizza le seguenti autorizzazioni:
PermissionDescriptionEndpoints
ManageAccountKnowledgeGestire le note Knowledge a livello Enterprise o di organizzazioneNotes endpoints (GET, POST, PUT, DELETE)
ManageAccountPlaybooksGestire i playbook a livello Enterprise o di organizzazionePlaybooks endpoints (GET, POST, PUT, DELETE)
ManageEnterpriseSettingsGestire le impostazioni a livello Enterprise, inclusi i tag organizzativiTags endpoints, Organization management

​
Ambiti degli utenti di servizio

Gli utenti di servizio Enterprise hanno accesso alle risorse a livello Enterprise e possono operare su tutte le organizzazioni all’interno dell’Enterprise. Usano gli endpoint sotto /v3beta1/enterprise/*. Gli utenti di servizio dell’organizzazione sono limitati a una specifica organizzazione e possono accedere solo alle risorse all’interno di tale organizzazione. Usano gli endpoint sotto /v3beta1/organizations/{org_id}/*.

​
Creazione dei Service user

I Service user possono essere creati tramite:
  • Impostazioni Enterprise → Service users: crea Service user a livello Enterprise o a livello di organizzazione con ruoli personalizzati
Per informazioni dettagliate su autenticazione e generazione dei token, consulta la Guida all’autenticazione.

​
Self

Ottieni informazioni sull’utente di servizio autenticato:

Get Self

Ottieni informazioni sull’utente di servizio autenticato

​
Log di audit

Accedi a log di audit completi:

Log di audit Enterprise

Ottieni i log di audit a livello Enterprise

Log di audit dell'organizzazione

Ottieni i log di audit per una determinata organizzazione

​
Consumo

Monitora metriche di consumo dettagliate:

Cicli di consumo

Visualizza i riepiloghi dei cicli di consumo

Consumo giornaliero

Visualizza la ripartizione giornaliera del consumo

Per organizzazione

Monitora il consumo per organizzazione

Per utente

Monitora il consumo per utente

Per sessione

Monitora il consumo per sessione

​
Organizzazioni

Gestisci le organizzazioni con controllo degli accessi basato sui ruoli (RBAC):

Elenca organizzazioni

Visualizza tutte le organizzazioni

Crea organizzazione

Crea una nuova organizzazione

Aggiorna organizzazione

Aggiorna le impostazioni dell’organizzazione

Elimina organizzazione

Elimina un’organizzazione

​
Utenti di servizio

Gestisci gli utenti di servizio sia a livello Enterprise che di organizzazione:

Elenca utenti di servizio Enterprise

Visualizza gli utenti di servizio Enterprise

Crea utente di servizio Enterprise

Crea un utente di servizio Enterprise

Aggiorna utente di servizio Enterprise

Aggiorna un utente di servizio Enterprise

Elimina utente di servizio Enterprise

Elimina un utente di servizio Enterprise

Elenca utenti di servizio dell'organizzazione

Visualizza gli utenti di servizio dell’organizzazione

Crea utente di servizio dell'organizzazione

Crea un utente di servizio dell’organizzazione

​
Utenti

Gestisci gli utenti a livello Enterprise e di organizzazione:

Elenca utenti Enterprise

Visualizza gli utenti Enterprise

Aggiungi utente Enterprise

Aggiungi un utente all’Enterprise

Aggiorna utente Enterprise

Aggiorna un utente Enterprise

Rimuovi utente Enterprise

Rimuovi un utente dall’Enterprise

Elenca utenti organizzazione

Visualizza gli utenti dell’organizzazione

Aggiungi utente organizzazione

Aggiungi un utente a un’organizzazione

​
Gruppi IdP

Gestisci i gruppi IdP a livello Enterprise e di organizzazione:

Elenca gruppi Enterprise

Visualizza i gruppi IdP dell’Enterprise

Aggiungi gruppo Enterprise

Aggiungi un gruppo IdP all’Enterprise

Elenca gruppi dell'organizzazione

Visualizza i gruppi IdP dell’organizzazione

Aggiungi gruppo all'organizzazione

Aggiungi un gruppo IdP a un’organizzazione

​
Autorizzazioni Git

Gestisci l’accesso al repository:

Elenca autorizzazioni

Visualizza le autorizzazioni Git per un’organizzazione

Aggiungi autorizzazione

Aggiungi un’autorizzazione Git

Rimuovi autorizzazione

Rimuovi un’autorizzazione Git

​
Note

Gestisci le note di conoscenza a livello Enterprise e di organizzazione:

Elenca note Enterprise

Visualizza le note di conoscenza a livello Enterprise

Crea nota Enterprise

Crea una nuova nota di conoscenza a livello Enterprise

Elenca note organizzazione

Visualizza le note di conoscenza a livello di organizzazione

Crea nota organizzazione

Crea una nuova nota di conoscenza a livello dell’organizzazione

​
Playbook

Gestisci i playbook a livello Enterprise e di organizzazione:

Elenca playbook Enterprise

Visualizza i playbook Enterprise

Crea playbook Enterprise

Crea un nuovo playbook Enterprise

Elenca playbook dell'organizzazione

Visualizza i playbook dell’organizzazione

Crea playbook dell'organizzazione

Crea un nuovo playbook dell’organizzazione

​
Sessioni

Gestisci le sessioni dell’organizzazione:

Elenca le sessioni

Visualizza le sessioni dell’organizzazione

Crea sessione

Crea una nuova sessione

​
Tag

Gestisci i tag dell’organizzazione (richiede la funzionalità di tag di sessione):

Visualizza tag

Visualizza i tag di un’organizzazione

Aggiungi tag

Aggiungi tag a un’organizzazione

Sostituisci tag

Sostituisci tutti i tag di un’organizzazione

Elimina tag

Rimuovi un tag specifico

​
Ruoli e metriche

Elenca ruoli

Visualizza i ruoli disponibili

Metriche di utilizzo

Recupera le metriche di utilizzo Enterprise

Metriche dell'organizzazione

Recupera le metriche di utilizzo dell’organizzazione

​
Esempi di utilizzo

Visualizza esempi di codice

Consulta esempi di codice e casi d’uso comuni dell’API v3