Salt la conținutul principal

​
Prezentare generală

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.
API-ul este disponibil numai pentru planurile Enterprise

​
URL de bază

Toate cererile către API trebuie trimise la: 
https://server.codeium.com/api/v1/

​
Autentificare

API-ul Windsurf utilizează chei de serviciu pentru autentificare. Cheile de serviciu trebuie incluse în corpul solicitării pentru toate apelurile API.

​
Crearea unei chei de serviciu

  1. Accesați pagina setărilor echipei
  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

​
Permisiuni necesare

Toate endpointurile Analytics API necesită permisiunea „Teams Read-only”. Toate endpointurile Usage API necesită permisiunea „Billing Write”.

​
Utilizarea cheilor de serviciu

Includeți cheia de serviciu în corpul cererii pentru toate apelurile API: 
{
  "service_key": "your_service_key_here",
  // ... alți parametri
}
Păstrați cheile de serviciu în siguranță și nu le expuneți niciodată în codul de pe client sau în depozite publice

​
Limitări de rată

Solicitările către API sunt supuse unei politici de limitare a ratei pentru a asigura stabilitatea serviciului. Dacă depășiți limita, veți primi un răspuns 429 Too Many Requests.

​
Asistență

Pentru asistență privind API-ul și pentru întrebări, vă rugăm să contactați Windsurf Support.