Vai al contenuto principale
Questa guida consente di migrare le integrazioni esistenti da API v1 o v2 alle API attuali di Organization ed Enterprise. Le API legacy (v1 e v2) continueranno a funzionare durante il periodo di dismissione, ma tutte le nuove funzionalità saranno disponibili solo nell’API attuale.

Cosa cambia

Passaggio 1: Crea un utente di servizio

Sostituisci la tua chiave API legacy con un utente di servizio:
  1. Vai a Settings > API di Devin e apri la tab utente di servizio
  2. Clicca su Provision service user, assegna un ruolo appropriato e scegli una scadenza (30 giorni per impostazione predefinita)
  3. Copia la API key mostrata dopo il provisioning (inizia con cog_)
  4. Aggiorna l’integrazione per usare la nuova API key
Le tue chiavi API legacy continueranno a funzionare durante il periodo di dismissione. Puoi eseguire la migrazione gradualmente.

Passaggio 2: Aggiornare gli URL degli endpoint

Endpoint delle sessioni

Endpoint di Knowledge

Endpoint dei playbook

Gli endpoint /playbooks sono deprecati in tutte le versioni dell’API. I playbook stanno migrando verso le Competenze. Crea le nuove istruzioni come skill nella pagina Personalizza. Gli account creati a partire dal 24 ottobre 2026 e privi di playbook ricevono il codice 410 da questi endpoint. Consulta I playbook stanno migrando verso le Competenze.

Endpoint dei secret

Endpoint disponibili solo per Enterprise (nuovi)

Questi endpoint non hanno un equivalente v1/v2 — sono disponibili solo nell’API attuale:
  • GET /v3/enterprise/organizations — Elenca le organizzazioni
  • GET /v3/enterprise/audit-logs — Log di audit
  • GET /v3/enterprise/consumption/* — Dati di utilizzo e fatturazione
  • GET /v3/enterprise/metrics/* — Metriche di utilizzo
  • GET /v3/enterprise/members/users — Gestione utenti
  • GET /v3/enterprise/roles — Gestione dei ruoli
  • Provisioning degli utenti di servizio, elenchi di accesso IP, limiti di ACU e altro

Passaggio 3: Aggiorna la paginazione

L’API attuale usa una paginazione basata su cursore anziché su offset:
Per maggiori dettagli, consulta Pagination.

Passaggio 4: Gestire le modifiche del formato della risposta

Valori dello stato della sessione

L’API attuale restituisce informazioni di stato più dettagliate. Consulta la documentazione dell’endpoint per lo schema completo.

Risposte di errore

L’API attuale restituisce gli errori nel formato RFC 9457, con content type application/problem+json. Il corpo contiene i membri type, title e status e può includere anche i membri detail, instance, errors ed error_code. Le API legacy restituiscono un corpo JSON con un membro detail. Nelle risposte 422 dell’API attuale, detail è una stringa, mentre il membro errors contiene gli errori a livello di campo.

Tempistiche di dismissione

Settings > API di Devin elenca le chiavi API legacy nella scheda API keys (legacy). Enterprise settings > API di Devin le elenca nella scheda API legacy, dove è visibile un banner che ne segnala la dismissione. Durante il periodo di transizione:
  • Ora: Le chiavi API legacy continuano a funzionare. Le nuove organizzazioni potrebbero non avere accesso alla creazione di chiavi API legacy.
  • Periodo di dismissione: Sia le chiavi API legacy che i token degli utenti di servizio funzionano in parallelo.
  • Fine del ciclo di vita: Le chiavi API legacy verranno rimosse a breve. Controlla regolarmente le impostazioni di Devin per eventuali annunci.
Consigliamo di eseguire la migrazione agli utenti di servizio il prima possibile per sfruttare il controllo degli accessi basato sui ruoli, l’attribuzione delle sessioni e le nuove funzionalità.

Hai bisogno di aiuto?

Se riscontri problemi durante la migrazione, contatta il tuo canale di supporto Devin abituale oppure scrivici a support@cognition.ai.