Vai al contenuto principale

​
Note di rilascio delle API

Questa pagina riepiloga le modifiche specifiche alle API di Devin (v1, v2 e v3). Per le nuove versioni delle funzionalità dell’applicazione, consulta le Note di rilascio dell’applicazione.

​
2025

​
Dicembre 2025

Aggiornamenti API v3
  • Router Notes e Playbooks (1 dic): Aggiunti endpoint di gestione di Notes e Playbooks a livello Enterprise e di organizzazione all’API v3. Gli endpoint di Notes richiedono l’autorizzazione ManageAccountKnowledge, gli endpoint di Playbooks richiedono l’autorizzazione ManageAccountPlaybooks.

​
Novembre 2025

Aggiornamenti API Enterprise v2
  • Aggiornamento del limite di paginazione (21 nov): Il limite massimo di paginazione è stato ridotto da 1000 a 200 elementi per richiesta per migliorare prestazioni e affidabilità. Il parametro limit predefinito rimane 100. Questa modifica NON influisce sulla v1 External API.
  • Router delle sessioni (16 nov): Aggiunti endpoint completi per la gestione delle sessioni all’API v2 per gli amministratori Enterprise.
  • Endpoint Snapshots API (3 nov): Aggiunto un endpoint per recuperare in modo programmatico i dettagli degli snapshot.
Aggiornamenti API v1
  • Endpoint di terminazione sessione (31 ott): Aggiunto un endpoint per terminare in modo programmatico le sessioni in esecuzione.

​
Ottobre 2025

Rilascio API v3 (Beta)
  • Rilascio API v3 (23 ott): Rilasciata l’API v3 con supporto completo per RBAC, modello di autenticazione basato su utenti di servizio e registrazione di audit completa delle azioni degli utenti di servizio.
Aggiornamenti Enterprise API v2
  • Endpoint di creazione snapshot (30 ott): Nuovo endpoint delle API Enterprise Organizations v2 che consente agli amministratori Enterprise di clonare in modo programmatico i repository e creare snapshot con passaggi di configurazione personalizzati e comandi di avvio.
  • Miglioramenti Playbooks API (14 ott): Aggiunta un’API per pubblicare playbook Enterprise con funzionalità migliorate per la gestione programmatica dei playbook.

​
Settembre 2025

Aggiornamenti API Enterprise v2
  • Router ruoli (25 set): Aggiunto il router dei ruoli Enterprise con cinque endpoint API per gestire i ruoli in modo programmatico.
Aggiornamenti API v1
  • Playbooks API (6 set): Aggiunti endpoint completi dell’API Playbooks alla v1 per creare, aggiornare, elencare ed eliminare playbook in modo programmatico.
  • Endpoint secrets (5 set): Aggiunto il nuovo endpoint POST /v1/secrets per creare segreti tramite API.

​
Marzo 2025

Lancio dell’Enterprise API v2
  • Lancio dell’API v2 (23 mar): È stata resa disponibile l’Enterprise API v2 per gli amministratori Enterprise, con funzionalità per la gestione delle organizzazioni, il monitoraggio dei consumi e la gestione dei membri.

​
2024

​
Ottobre 2024

Lancio API v1 (26 ott)
  • REST API per la creazione e la gestione programmatica delle sessioni
  • Endpoint per la creazione, il monitoraggio e la gestione delle sessioni
  • Supporto per il caricamento e il download di file allegati
  • Autenticazione di base con API key
  • Supporto per la creazione idempotente delle sessioni
  • Casi d’uso: revisioni automatiche delle PR, risoluzione degli errori di lint, migrazioni

​
Politica di versionamento delle API

​
Compatibilità con le versioni precedenti

Ci impegniamo a mantenere la compatibilità con le versioni precedenti all’interno delle versioni principali. Le modifiche che interrompono la compatibilità saranno:
  1. Annunciate con almeno 7 giorni di anticipo
  2. Documentate in queste note di rilascio
  3. Accompagnate da guide di migrazione, quando applicabile

​
Processo di deprecazione

Quando contrassegniamo come deprecata una funzionalità API:
  1. Annuncio: Annunciamo la deprecazione con una tempistica
  2. Periodo di deprecazione: La funzionalità rimane disponibile ma contrassegnata come deprecata
  3. Rimozione: La funzionalità viene rimossa al termine del periodo di deprecazione

​
Supporto versioni

  • v1: Generalmente disponibile, in manutenzione attiva
  • v2: Generalmente disponibile, in manutenzione attiva
  • v3: Beta - soggetta a modifiche, non ancora consigliata per l’uso in produzione

​
Guide alla migrazione

​
Migrazione da v1 a v3

Se stai creando nuove integrazioni che richiedono permessi granulari, prendi in considerazione l’uso di v3 invece di v1: Differenze principali:
  • Autenticazione: v3 richiede token di utente di servizio invece di API key personali/di servizio
  • Autorizzazione: v3 fornisce un RBAC completo con autorizzazioni basate sui ruoli
  • Endpoint: v3 utilizza pattern di URL diversi (/v3beta1/* invece di /v1/*)
Passaggi di migrazione:
  1. Crea un utente di servizio in Enterprise Settings > Service Users
  2. Assegna i ruoli appropriati all’utente di servizio
  3. Genera una API key per l’utente di servizio
  4. Aggiorna la tua integrazione per utilizzare gli endpoint v3
  5. Esegui test approfonditi in un ambiente non di produzione
Visualizza la documentazione API v3 →

​
Migrazione dalla v2 alla v3

La v3 offre maggiore flessibilità rispetto alla v2 per l’automazione a livello Enterprise: Differenze principali:
  • Autenticazione: la v3 utilizza utenti di servizio invece di richiedere chiavi personali degli Enterprise Admin
  • Autorizzazione: la v3 supporta un controllo di accesso basato sui ruoli (RBAC) granulare invece dell’accesso limitato esclusivamente agli Enterprise Admin
  • Ambito: la v3 può essere limitata a specifiche organizzazioni, mentre la v2 è sempre a livello Enterprise
Quando migrare:
  • Se hai bisogno di automazione con permessi non amministrativi
  • Se vuoi limitare l’accesso alle API a specifiche organizzazioni
  • Se ti serve una chiara separazione tra account umani e account di servizio
  • Se richiedi log di audit dettagliati per le azioni automatizzate

​
Supporto

Per domande sulle modifiche all’API o per ricevere assistenza nella migrazione: