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

# Référence de l’API

> API d’entreprise permettant d’interroger les données d’utilisation de Devin Desktop et de gérer les configurations via l’authentification par clé de service.

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

L’API Devin Desktop permet aux clients Enterprise d’accéder par programmation à des données d’analyse détaillées sur l’utilisation et de gérer les paramètres d’utilisation de leurs équipes.

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

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

Toutes les requêtes de l’API doivent être adressées à :

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

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

L’API Devin Desktop utilise des clés de service pour l’authentification. Les clés de service doivent être incluses dans le corps de chaque appel d’API.

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

1. Accédez à la [page Team Settings](https://windsurf.com/team/settings)
2. Ouvrez la section "Service Keys"
3. Créez une nouvelle clé de service avec les autorisations appropriées
4. Copiez la clé de service générée afin de l'utiliser dans les requêtes API

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

Différents endpoints 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   |
| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| [Analyse personnalisée](/fr/desktop/accounts/api-reference/custom-analytics) (`/Analytics`)                                      | Analyse en lecture     |
| [Analyse de la page utilisateur](/fr/desktop/accounts/api-reference/user-page-analytics) (`/UserPageAnalytics`)                  | Teams en lecture seule |
| [Analyse Cascade](/fr/desktop/accounts/api-reference/cascade-analytics) (`/CascadeAnalytics`)                                    | Teams en lecture seule |
| [Définir la configuration d’utilisation](/fr/desktop/accounts/api-reference/usage-config) (`/UsageConfig`)                       | Billing en écriture    |
| [Récupérer la configuration d’utilisation](/fr/desktop/accounts/api-reference/get-usage-config) (`/GetUsageConfig`)              | Billing en lecture     |
| [Récupérer le solde de crédits de la Team](/fr/desktop/accounts/api-reference/get-team-credit-balance) (`/GetTeamCreditBalance`) | Billing en lecture     |

<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 d’API :

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

<Warning>Conservez vos clés de service en lieu sûr et ne les exposez jamais dans du code côté client ou des dépôts publics</Warning>

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

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

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

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