Skip to main content
Le API di Devin consentono di integrare Devin nelle tue applicazioni, automatizzare i flussi di lavoro e creare strumenti potenti. Usa service users con controllo degli accessi basato sui ruoli per un accesso alle API sicuro e verificabile.

​
Per iniziare

Guida rapida per team

Per team e organizzazioni standard. Crea un utente di servizio ed effettua la tua prima chiamata all’API in pochi minuti.

Guida rapida Enterprise

Per clienti Enterprise con RBAC, supporto multi-organizzazione e autorizzazioni avanzate.
Quale percorso scegliere? La maggior parte dei clienti dovrebbe iniziare dalla guida rapida per team. Scegli Enterprise se gestisci più organizzazioni, utilizzi SSO o hai bisogno di ruoli personalizzati e RBAC.

​
Struttura delle API

L’API è organizzata in due ambiti:

​
API dell’organizzazione

Base URL: https://api.devin.ai/v3/organizations/* Per gestire le risorse all’interno di una singola organizzazione — sessioni, Knowledge, playbook, segreti e altro. Qui ha inizio la maggior parte delle integrazioni.

​
API Enterprise

Base URL: https://api.devin.ai/v3/enterprise/* Per la gestione tra più organizzazioni — analisi, log di audit, gestione degli utenti, fatturazione e infrastruttura. Disponibile per i clienti Enterprise. Entrambi gli scope utilizzano credenziali di utente di servizio (prefisso cog_). Consultare Autenticazione per la configurazione.

​
Attribuzione delle sessioni

Gli utenti di servizio sono identità distinte dagli utenti umani, ma puoi creare sessioni per conto di qualsiasi utente all’interno della tua organizzazione usando il parametro create_as_user_id. In questo modo le sessioni compaiono nell’elenco delle sessioni di quell’utente e vengono conteggiate nel suo utilizzo — proprio come se le avesse create personalmente.
Stai passando dalle chiavi API personali? Nelle v1/v2, le chiavi API personali creavano automaticamente le sessioni come il tuo utente. Con la v3, usa un utente di servizio + create_as_user_id per ottenere lo stesso comportamento, con il vantaggio aggiuntivo di RBAC, audit trail e gestione centralizzata delle chiavi. Il ruolo dell’utente di servizio deve includere l’autorizzazione ImpersonateOrgSessions.
Puoi anche autenticarti direttamente come il tuo utente con un Personal Access Token, senza bisogno di un utente di servizio o di create_as_user_id. Le sessioni vengono automaticamente attribuite a te.
Puoi trovare gli ID utente tramite l’endpoint List organization users (beta, richiede un utente di servizio con ambito di organizzazione) o l’endpoint enterprise List users. Entrambi restituiscono solo gli utenti con assegnazioni di ruolo dirette. Per gli utenti la cui appartenenza deriva da gruppi IDP, usa List organization IDP group users o il relativo equivalente enterprise.

​
API legacy (v1 e v2)

Le API v1 e v2 continueranno a funzionare durante il periodo di deprecazione, ma non riceveranno nuove funzionalità. Consigliamo di migrare all’API attuale per il controllo degli accessi basato sui ruoli, l’attribuzione delle sessioni e le nuove funzionalità.

​
Gestione degli errori

Tutte le API utilizzano i codici di stato HTTP standard:
  • 200 OK: Richiesta completata con successo
  • 201 Created: Risorsa creata correttamente
  • 400 Bad Request: Parametri della richiesta non validi
  • 401 Unauthorized: Chiave API mancante o non valida
  • 403 Forbidden: Autorizzazioni insufficienti
  • 404 Not Found: Risorsa non trovata
  • 429 Too Many Requests: Limite di richieste superato
  • 500 Internal Server Error: Errore del server

​
Supporto

Per domande sull’API o per segnalare problemi, scrivi a support@cognition.ai.