> ## 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.

# Référence de l’API

> API Enterprise pour interroger les données d’utilisation de Windsurf et gérer la configuration avec authentification par clé de service.

<div id="overview">
  ## Vue d’ensemble
</div>

L’API Windsurf permet aux clients Enterprise d’accéder par programmation à des Analytics d’utilisation détaillées et de gérer les paramètres d’utilisation pour leurs équipes.

<Note>L’API est disponible uniquement pour les offres Enterprise</Note>

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

Toutes les requêtes vers l’API doivent être effectuées à l’adresse :

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

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

L'API Windsurf utilise des clés de service pour l'authentification. Les clés de service doivent être incluses dans le corps de la requête pour tous les appels à l'API.

<div id="creating-a-service-key">
  ### Création d’une clé de service
</div>

1. Accédez à votre [page des paramètres d’équipe](https://windsurf.com/team/settings)
2. Allez à la section « Clés de service »
3. Créez une nouvelle clé de service avec les autorisations appropriées
4. Copiez la clé de service générée pour l’utiliser dans les requêtes d’API

<div id="required-permissions">
  ### Autorisations requises
</div>

Différents endpoints de l'API nécessitent différentes autorisations. Reportez-vous à la documentation de chaque endpoint pour connaître l'autorisation spécifique requise :

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

<div id="using-service-keys">
  ### Utilisation des clés de service
</div>

Incluez votre clé de service dans le corps de la requête pour tous les appels à l’API :

```json theme={null}
{
  "service_key": "your_service_key_here",
  // ... autres paramètres
}
```

<Warning>Protégez vos clés de service et ne les exposez jamais dans du code côté client ni dans des dépôts publics</Warning>

<div id="rate-limits">
  ## Limitation du taux de requêtes
</div>

Les requêtes adressées à l’API sont soumises à une limitation de débit afin de garantir la stabilité du service. Si vous dépassez ce seuil, vous recevrez une réponse `429 Too Many Requests`.

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

Pour l’assistance concernant l’API et pour toute question, veuillez contacter le [support Windsurf](https://windsurf.com/support).