Vai al contenuto principale
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. 
curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Fix the login bug in issue #42",
    "create_as_user_id": "user_abc123"
  }'
Stai passando dalle API key personali? Nelle v1/v2, le API key personali creavano automaticamente le sessioni come il tuo utente. Con la v3, usa un service user + create_as_user_id per ottenere lo stesso comportamento, con il vantaggio aggiuntivo di RBAC, audit trail e gestione centralizzata delle chiavi. Il ruolo del service user deve includere il permesso ImpersonateOrgSessions.
Personal Access Tokens (PATs) in arrivo. I PAT ti permetteranno di autenticarti direttamente come il tuo utente con la v3 API, senza bisogno di un service user o di create_as_user_id. Le sessioni verranno automaticamente attribuite a te. Resta in attesa per la disponibilità.
Puoi trovare gli ID utente tramite l’endpoint List users o nella UI di Devin nelle impostazioni dei membri dell’organizzazione.

​
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.