Skip to main content
Le API v2 sono in alpha e sono soggette a modifiche in qualsiasi momento.

​
Panoramica

L’API di analisi v2 è la nuova generazione dell’API di analisi di Devin Desktop. Espone i dati di consumption (crediti e ACU), gli utenti attivi e l’output dell’agente (righe di codice accettate) tramite endpoint REST chiari, con filtri tramite parametri di query, raggruppamento flessibile e paginazione basata su cursore.
Gli endpoint v2 sono attualmente disponibili con il prefisso /api/v2alpha mentre l’API è in fase di definizione finale. L’URL di base è https://server.codeium.com.

​
Novità in v2

La differenza principale rispetto a v1 è l’autenticazione.

​
Autenticazione

v2 utilizza l’autenticazione con token Bearer. Passa la tua credenziale nell’header Authorization anziché nel corpo della richiesta:
Sono accettati due tipi di credenziali: una API key dell’utente di servizio Devin (consigliata — la stessa chiave cog_ utilizzata per la Devin API) o una chiave di servizio Windsurf.

​
API key degli utenti di servizio Devin

Se gestisci già utenti di servizio Devin, non ti servono credenziali Windsurf separate:
  1. Esegui il provisioning di un utente di servizio in Settings > API di Devin (scheda Utenti di servizio) per un’organizzazione, oppure Enterprise Settings > API di Devin (scheda Utenti di servizio) per l’Enterprise
  2. Assegnagli un ruolo personalizzato che includa l’ autorizzazione Use Local Analytics API (il ruolo Admin predefinito la include già)
  3. Copia l’API key mostrata dopo il provisioning: inizia con cog_
  4. Usa questa chiave come token Bearer
I risultati riguardano l’intero account Devin a cui appartiene l’utente di servizio e metadata.team_id è l’identificatore del team Devin dell’account (devin-team$<account_id>).
Il filtro group_id è un concetto proprio dei team Windsurf e non è supportato dalle credenziali Devin — le richieste che combinano i due restituiscono 400 Bad Request.

​
Chiavi di servizio Windsurf

  1. Vai alla pagina Team Settings del tuo team
  2. Vai alla sezione “Service Keys”
  3. Crea una nuova chiave di servizio con l’autorizzazione Analytics Read
  4. Usa la chiave come token Bearer nell’header Authorization
Sono supportate chiavi di servizio con ambito di gruppo: quando una chiave è limitata a un gruppo, i risultati vengono automaticamente limitati a quel gruppo.
Tieni al sicuro queste credenziali e non esporle mai nel codice lato client o in repository pubblici.

​
Endpoint disponibili

​
Strategia di fatturazione

Le risposte relative al consumption si adattano alla strategia di fatturazione del team, indicata in metadata.billing_strategy (le risposte relative all’output e agli utenti attivi non cambiano):
  • CREDITS — le righe includono prompt_credits e flex_credits
  • ACU — le righe includono billed_acus
I campi message_count (eventi di fatturazione) e user_message_count (messaggi inviati dall’utente, null per l’utilizzo precedente al 2026-04-11) vengono sempre restituiti, indipendentemente dalla strategia.

​
Paginazione

Le risposte che restituiscono elenchi sono paginate. Quando sono disponibili altri dati, la risposta include un pagination.next_page_cursor; passalo di nuovo come parametro di query page_cursor per recuperare la pagina successiva. I cursori scadono dopo 24 ore.

​
Limiti di frequenza

Questi endpoint non sono destinati al monitoraggio dell’utilizzo in tempo reale. I dati vengono aggregati su base oraria e il limite di frequenza è basso (10 richieste all’ora per team). Usali per report periodici ed esportazioni in blocco, non per dashboard in tempo reale o per il tracciamento delle singole richieste.
Gli endpoint v2 sono soggetti a un limite di frequenza di 10 richieste all’ora per team. Se il limite viene superato, viene restituito 429 Too Many Requests con un header Retry-After. La paginazione di una query precedente (seguendo un next_page_cursor) non viene conteggiata ai fini del limite di frequenza — viene conteggiata solo la query iniziale per ciascun report. Il limite ridotto riflette il fatto che questi endpoint sono pensati per report periodici, non per il monitoraggio in tempo reale.