Vai al contenuto principale
Ogni endpoint API è protetto da una specifica autorizzazione assegnata al ruolo dell’utente di servizio chiamante. 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 Enterprise quick start.
Trova l’ID della tua organizzazione nella pagina Impostazioni → Utenti di servizio.
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

PermissionControls
ReadAccountMetaAccount stesso (concessa per impostazione predefinita a tutti gli utenti di servizio)
ManageEnterpriseSettingsLog di audit, tag dell’organizzazione
ManageOrganizationsCRUD delle organizzazioni, limiti dei gruppi di organizzazioni
ManageAccountMembershipRuoli, utenti Enterprise, gruppi IdP Enterprise, appartenenza degli utenti di servizio Enterprise, registrazione dei gruppi IdP Enterprise
ManageAccountServiceUsersProvisioning degli utenti di servizio (enterprise)
ManageAccountKnowledgeNote Knowledge (enterprise)
ManageAccountPlaybooksPlaybook (enterprise)
ManageGitIntegrationsConnessioni Git, autorizzazioni Git
ManageBillingCicli di consumo, ripartizioni giornaliere del consumo
ViewAccountMetricsMetriche di utilizzo (DAU/WAU/MAU, PR, sessioni, ricerche, utenti attivi), stato della coda
ViewEnterpriseInfraDetailsHypervisor
ViewAccountSessionsElenco e dettagli delle sessioni (enterprise, sola lettura)
ManageAccountSessionsInvio di messaggi alle sessioni (enterprise)

​
Autorizzazioni dell’organizzazione

PermissionControls
ManageOrgSecretsOperazioni CRUD sui segreti
ManageOrgKnowledgeNote di Knowledge (organizzazione)
ManageOrgPlaybooksPlaybook (organizzazione)
ManageOrgServiceUsersProvisioning degli utenti di servizio (organizzazione)
ManageOrgSchedulesSessioni pianificate
ViewOrgSessionsElenco e dettagli delle sessioni (organizzazione, solo lettura)
ManageOrgSessionsInviare messaggi, terminare, archiviare le sessioni
UseDevinSessionsCreare sessioni
ImpersonateOrgSessionsCreare sessioni per conto di altri utenti (create_as_user_id)

​
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 → Service Users
  2. Utenti di servizio dell’organizzazione: Organization settings → Service Users
Per le istruzioni sulla configurazione, consulta la guida rapida per i team o la guida rapida Enterprise.