Skip to main content
Ogni endpoint API, ad eccezione di GET /v3/self, è protetto da una specifica autorizzazione. Un utente di servizio ottiene le proprie autorizzazioni dal ruolo assegnato; un token di accesso personale dispone delle stesse autorizzazioni dell’utente che lo ha creato. L’autorizzazione richiesta per ciascun endpoint è documentata nella relativa pagina di riferimento API. Questa pagina fornisce un riepilogo di tutte le autorizzazioni per ambito. URL di base:
  • https://api.devin.ai/v3/organizations/* — endpoint con ambito limitato a una singola organizzazione
  • https://api.devin.ai/v3/enterprise/* — endpoint che richiedono autorizzazioni a livello Enterprise
I clienti Devin Enterprise con un’istanza dedicata devono sostituire api.devin.ai con il proprio dominio API personalizzato (ad esempio, api.your-company.devinenterprise.com). Per i dettagli sulla configurazione, consulta la sezione guida rapida Enterprise.
Trova l’ID della tua organizzazione in cima alla pagina Impostazioni → Devin API.
Alcuni endpoint Enterprise operano su organizzazioni specifiche utilizzando percorsi come /v3/enterprise/organizations/{org_id}/... (ad esempio, log di audit e tag). Anche se includono un parametro org_id, richiedono autorizzazioni a livello Enterprise.

​
Autorizzazioni Enterprise

​
Autorizzazioni dell’organizzazione

​
Ereditarietà delle autorizzazioni

Gli utenti di servizio Enterprise si autenticano tramite gli endpoint /v3/enterprise/* e possono operare su tutte le organizzazioni. Hanno ruoli a livello di Enterprise ed ereditano automaticamente le corrispondenti autorizzazioni a livello di organizzazione in ogni organizzazione (ad esempio, ViewAccountSessions concede ViewOrgSessions in tutte le org). Gli utenti di servizio di organizzazione sono limitati a una singola organizzazione e si autenticano solo tramite gli endpoint /v3/organizations/{org_id}/*. A loro vengono assegnati ruoli a livello di organizzazione.

​
Creazione di utenti di servizio

Gli utenti di servizio vengono creati dall’interfaccia di Devin:
  1. Utenti di servizio Enterprise: Enterprise settings → Devin API (tab Service users)
  2. Utenti di servizio dell’organizzazione: Organization settings → Devin API (tab Service users)
Per le istruzioni sulla configurazione, consulta la guida rapida per i team o la guida rapida Enterprise.