Vai al contenuto principale
Le API di Devin consentono di integrare Devin nelle tue applicazioni, automatizzare i flussi di lavoro e creare strumenti potenti. Forniamo tre versioni di API, ognuna progettata per diversi casi d’uso e modelli di autenticazione.

​
Versioni API

Devin offre tre versioni dell’API, ciascuna con funzionalità e requisiti di autenticazione differenti:

​
API esterna v1 (ambito organizzazione)

L’API v1 fornisce le funzionalità principali di gestione delle sessioni con accesso a livello di organizzazione. Base URL: https://api.devin.ai/v1/* Autenticazione: API key personali o di servizio Funzionalità principali:
  • Creare e gestire sessioni di Devin
  • Inviare messaggi alle sessioni attive
  • Gestire segreti, Knowledge e playbook
  • Caricare e scaricare allegati
  • Aggiornare i tag delle sessioni
Ideale per:
  • Automazione generale delle sessioni
  • Integrazioni per gli utenti finali
  • Pipeline CI/CD
  • Sviluppo e test
Visualizza la documentazione dell’API v1 →

​
API Enterprise v2 (solo Amministratore Enterprise)

L’API v2 fornisce funzionalità di gestione e analisi a livello enterprise. Base URL: https://api.devin.ai/v2/enterprise/* Autenticazione: solo API key personali dell’Enterprise Admin Funzionalità principali:
  • Analisi e insight sulle sessioni a livello enterprise
  • Gestione di organizzazioni e membri
  • Monitoraggio dei consumi e dati di fatturazione
  • Log di audit e report di conformità
  • Gestione dei permessi Git
  • Indicizzazione dei repository
Ideale per:
  • Amministratori Enterprise
  • Analisi e reportistica
  • Conformità e audit
  • Gestione delle organizzazioni
Visualizza la documentazione dell’API v2 →

​
API per utenti di servizio v3 (RBAC)

L’API v3 fornisce pieno supporto RBAC con autenticazione tramite utente di servizio. URL di base:
  • https://api.devin.ai/v3beta1/enterprise/*
  • https://api.devin.ai/v3beta1/organizations/*
Autenticazione: Credenziali di utente di servizio (livello Enterprise o Organization) Funzionalità principali:
  • Controllo degli accessi basato sui ruoli (RBAC) completo
  • Utenti di servizio con ruoli dedicati
  • Autorizzazioni granulari
  • Flussi di lavoro multi-organizzazione
  • Chiara separazione tra account umani e account di servizio
Ideale per:
  • Automazione in ambienti di produzione con permessi specifici
  • Integrazioni multi-organizzazione
  • Flussi di lavoro con requisiti stringenti di conformità
  • Integrazioni di servizio di lunga durata
Visualizza la documentazione dell’API v3 →

​
Guida rapida

​
Ottenere una API key

  1. Per l’API v1: Genera una API key da Settings > API Keys in qualsiasi sottoorganizzazione
  2. Per l’API v2: Genera una API key personale da Settings > API Keys in qualsiasi sottoorganizzazione
  3. Per l’API v3: Crea un service user da Enterprise Settings > Service Users
Mantieni le tue API key al sicuro e non condividerle mai in aree accessibili pubblicamente, come repository GitHub o codice lato client.

​
Esegui la tua prima richiesta

Includi la tua API key nell’intestazione Authorization: 
Authorization: Bearer your_api_key_here
Esempio: creare una sessione v1: 
curl -X POST "https://api.devin.ai/v1/sessions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Crea un semplice script Python che stampi Hello World"
  }'

​
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 [email protected].