> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Riferimento API

> API Enterprise per recuperare i dati di utilizzo di Devin Desktop e gestire le configurazioni con autenticazione tramite chiave di servizio.

<div id="overview">
  ## Panoramica
</div>

L'API di Devin Desktop consente ai clienti Enterprise di accedere a dati analitici dettagliati sull'utilizzo in modo programmatico e di gestire le configurazioni di utilizzo dei propri team.

<Note>L'API è disponibile solo con i piani Enterprise</Note>

<div id="base-url">
  ## URL di base
</div>

Tutte le richieste API devono essere inviate a:

```
https://server.codeium.com/api/v1/
```

<div id="authentication">
  ## Autenticazione
</div>

L'API di Devin Desktop utilizza chiavi di servizio per l'autenticazione. Le chiavi di servizio devono essere incluse nel corpo della richiesta per tutte le chiamate API.

<div id="creating-a-service-key">
  ### Creare una chiave di servizio
</div>

1. Vai alla [pagina Team Settings](https://windsurf.com/team/settings)
2. Vai alla sezione "Service Keys"
3. Crea una nuova chiave di servizio con le autorizzazioni appropriate
4. Copia la chiave di servizio generata da usare nelle richieste API

<div id="required-permissions">
  ### Autorizzazioni richieste
</div>

Endpoint API diversi richiedono autorizzazioni diverse. Consulta la documentazione di ciascun endpoint per l'autorizzazione specifica richiesta:

| Endpoint                                                                                                                   | Autorizzazione richiesta |
| -------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| [Analytics personalizzate](/it/desktop/accounts/api-reference/custom-analytics) (`/Analytics`)                             | Analytics Read           |
| [Analytics della pagina utente](/it/desktop/accounts/api-reference/user-page-analytics) (`/UserPageAnalytics`)             | Teams Read-Only          |
| [Analytics Cascade](/it/desktop/accounts/api-reference/cascade-analytics) (`/CascadeAnalytics`)                            | Teams Read-Only          |
| [Imposta la configurazione di utilizzo](/it/desktop/accounts/api-reference/usage-config) (`/UsageConfig`)                  | Billing Write            |
| [Recupera la configurazione di utilizzo](/it/desktop/accounts/api-reference/get-usage-config) (`/GetUsageConfig`)          | Billing Read             |
| [Recupera il saldo crediti del team](/it/desktop/accounts/api-reference/get-team-credit-balance) (`/GetTeamCreditBalance`) | Billing Read             |

<div id="using-service-keys">
  ### Uso delle chiavi di servizio
</div>

Includi la tua chiave di servizio nel corpo di tutte le richieste API:

```json theme={null}
{
  "service_key": "your_service_key_here",
  // ... altri parametri
}
```

<Warning>Tieni al sicuro le tue chiavi di servizio e non esporle mai nel codice lato client o in repository pubblici</Warning>

<div id="rate-limits">
  ## Limiti di frequenza
</div>

Le richieste API sono soggette a limiti di frequenza per garantire la stabilità del servizio. Se superi il limite di frequenza, riceverai una risposta `429 Too Many Requests`.

<div id="support">
  ## Supporto
</div>

Per assistenza e domande sull'API, contatta [Devin Desktop Support](https://windsurf.com/support).