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

# Referință API

> API Enterprise pentru interogarea datelor de utilizare în Windsurf și gestionarea configurațiilor cu autentificare prin cheie de serviciu.

<div id="overview">
  ## Prezentare generală
</div>

API-ul Windsurf le permite clienților Enterprise să acceseze programatic Analytics detaliate privind utilizarea și să gestioneze configurările de utilizare pentru echipele lor.

<Note>API-ul este disponibil numai pentru planurile Enterprise</Note>

<div id="base-url">
  ## URL de bază
</div>

Toate cererile către API trebuie trimise la:

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

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

API-ul Windsurf folosește chei de serviciu pentru autentificare. Cheile de serviciu trebuie să fie incluse în corpul solicitării pentru toate apelurile API.

<div id="creating-a-service-key">
  ### Crearea unei chei de serviciu
</div>

1. Accesați [pagina setărilor echipei](https://windsurf.com/team/settings)
2. Mergeți la secțiunea „Chei de serviciu”
3. Creați o nouă cheie de serviciu cu permisiunile corespunzătoare
4. Copiați cheia de serviciu generată pentru a o utiliza în solicitările către API

<div id="required-permissions">
  ### Permisiuni necesare
</div>

Diverse endpoint-uri API necesită permisiuni diferite. Consultați documentația fiecărui endpoint pentru permisiunea specifică necesară:

| Endpoint                                                                                                         | Permisiune necesară |
| ---------------------------------------------------------------------------------------------------------------- | ------------------- |
| [Custom Analytics](/ro/windsurf/accounts/api-reference/custom-analytics) (`/Analytics`)                          | Analytics Read      |
| [User Page Analytics](/ro/windsurf/accounts/api-reference/user-page-analytics) (`/UserPageAnalytics`)            | Teams Read-Only     |
| [Cascade Analytics](/ro/windsurf/accounts/api-reference/cascade-analytics) (`/CascadeAnalytics`)                 | Teams Read-Only     |
| [Set Usage Configuration](/ro/windsurf/accounts/api-reference/usage-config) (`/UsageConfig`)                     | Billing Write       |
| [Get Usage Configuration](/ro/windsurf/accounts/api-reference/get-usage-config) (`/GetUsageConfig`)              | Billing Read        |
| [Get Team Credit Balance](/ro/windsurf/accounts/api-reference/get-team-credit-balance) (`/GetTeamCreditBalance`) | Billing Read        |

<div id="using-service-keys">
  ### Utilizarea cheilor de serviciu
</div>

Includeți cheia de serviciu în corpul cererii pentru toate apelurile API:

```json theme={null}
{
  "service_key": "your_service_key_here",
  // ... alți parametri
}
```

<Warning>Păstrați cheile de serviciu în siguranță și nu le expuneți niciodată în codul de pe client sau în depozite publice</Warning>

<div id="rate-limits">
  ## Limitări de rată a solicitărilor
</div>

Solicitările către API sunt supuse unor limitări de rată pentru a menține stabilitatea serviciului. Dacă depășiți limita de rată a solicitărilor, veți primi un răspuns `429 Too Many Requests`.

<div id="support">
  ## Asistență
</div>

Pentru asistență privind API-ul și pentru întrebări, vă rugăm să contactați [Windsurf Support](https://windsurf.com/support).