> ## 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 consulter les données d’utilisation de Windsurf et gérer les configurations avec authentification par clé de service.

<div id="overview">
  ## Présentation
</div>

L’API Windsurf permet aux clients Enterprise d’accéder de manière programmatique à des Analytics d’utilisation détaillées et de gérer les paramètres d’utilisation de 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 à l’API doivent être envoyées à :

```
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 API.

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

1. Accédez à la [page des paramètres de votre équipe](https://windsurf.com/team/settings)
2. Accédez à 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 à l’API

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

Les différents points de terminaison d’API nécessitent des autorisations différentes. Consultez la documentation de chaque endpoint pour connaître l’autorisation spécifique requise :

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

<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>Conservez vos clés de service en sécurité et ne les exposez jamais dans du code côté client ni dans des dépôts publics</Warning>

<div id="rate-limits">
  ## Limites de débit
</div>

Les requêtes API sont soumises à des limites de débit afin de garantir la stabilité du service. Si vous dépassez la limite de débit, vous recevrez une réponse `429 Too Many Requests`.

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

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