> ## 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 Windsurf și administrarea 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 configurațiile de utilizare pentru echipele lor.

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

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

Toate solicitările 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 incluse în corpul solicitării pentru toate apelurile către 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 folosi în solicitările API

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

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

| Endpoint                                                                                                                    | Permisiune necesară |
| --------------------------------------------------------------------------------------------------------------------------- | ------------------- |
| [Analytics personalizate](/ro/plugins/accounts/api-reference/custom-analytics) (`/Analytics`)                               | Analytics Read      |
| [Analytics pentru pagina utilizatorului](/ro/plugins/accounts/api-reference/user-page-analytics) (`/UserPageAnalytics`)     | Teams Read-Only     |
| [Cascade Analytics](/ro/plugins/accounts/api-reference/cascade-analytics) (`/CascadeAnalytics`)                             | Teams Read-Only     |
| [Setare configurație de utilizare](/ro/plugins/accounts/api-reference/usage-config) (`/UsageConfig`)                        | Billing Write       |
| [Obținere configurație de utilizare](/ro/plugins/accounts/api-reference/get-usage-config) (`/GetUsageConfig`)               | Billing Read        |
| [Obținere sold de credite al echipei](/ro/plugins/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 solicitării 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 client sau în depozite publice</Warning>

<div id="rate-limits">
  ## Limite de rată
</div>

Cererile către API sunt supuse unor limite de rată pentru a asigura stabilitatea serviciului. Dacă depășiți aceste limite, veți primi un răspuns de tip `429 Too Many Requests`.

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

Pentru suport și întrebări legate de API, vă rugăm să contactați [Windsurf Support](https://windsurf.com/support).