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

# Obtenir la configuration d’utilisation

> Récupérer la configuration des plafonds d’utilisation pour les crédits d’extension par utilisateur, avec des requêtes au niveau de l’équipe, du groupe ou de l’utilisateur individuel pour la gestion de la facturation Enterprise.

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

Récupérez la configuration actuelle du plafond de crédits d’add-on par utilisateur pour votre organisation. Les plafonds sont toujours définis par utilisateur. Lorsque vous interrogez par périmètre d’équipe ou de groupe, la réponse renvoie le plafond par utilisateur qui a été appliqué aux utilisateurs au sein de cette équipe ou de ce groupe.

<div id="request">
  ## Requête
</div>

<ParamField body="service_key" type="string" required>
  Votre clé de service avec les autorisations « Billing Read »
</ParamField>

<div id="scope-configuration-choose-one">
  ### Configuration de la portée (Choisissez-en une)
</div>

<ParamField body="team_level" type="boolean">
  Définissez la valeur sur `true` pour récupérer le plafond par utilisateur appliqué à tous les utilisateurs de l'équipe
</ParamField>

<ParamField body="group_id" type="string">
  Récupérez le plafond par utilisateur appliqué à tous les utilisateurs d'un groupe spécifique en fournissant l'ID du groupe
</ParamField>

<ParamField body="user_email" type="string">
  Récupérez la configuration pour un utilisateur spécifique en fournissant son adresse e-mail
</ParamField>

<Info>
  Vous devez fournir l'un des paramètres `team_level`, `group_id` ou `user_email` pour définir la portée.
</Info>

<div id="example-request-get-per-user-cap-for-all-users-on-team">
  ### Exemple de requête - Obtenir la limite par utilisateur pour tous les membres de l'équipe
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "team_level": true
}' \
https://server.codeium.com/api/v1/GetUsageConfig
```

<div id="example-request-get-per-user-cap-for-all-users-in-a-group">
  ### Exemple de requête - Récupérer le plafond par utilisateur pour tous les utilisateurs d’un groupe
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "group_id": "engineering_team"
}' \
https://server.codeium.com/api/v1/GetUsageConfig
```

<div id="example-request-get-user-configuration">
  ### Exemple de requête - Récupérer la configuration utilisateur
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "user_email": "user@example.com"
}' \
https://server.codeium.com/api/v1/GetUsageConfig
```

<div id="response">
  ## Réponse
</div>

<ResponseField name="addOnCreditCap" type="integer">
  Valeur configurée du plafond de crédits de l’add-on. Si ce champ n’est pas présent dans la réponse, aucun plafond n’est configuré au niveau de périmètre demandé.
</ResponseField>

<div id="example-response-with-cap-configured">
  ### Exemple de réponse - avec un plafond configuré
</div>

```json theme={null}
{
  "addOnCreditCap": 10000
}
```

<div id="example-response-no-cap-configured">
  ### Exemple de réponse - Aucun plafond défini
</div>

```json theme={null}
{}
```

<div id="error-responses">
  ## Réponses d’erreur
</div>

Scénarios d’erreur courants :

* Clé de service invalide ou autorisations insuffisantes
* Plusieurs paramètres de scope fournis
* Aucun paramètre de scope fourni
* ID de groupe ou adresse e-mail utilisateur invalide
* Limite de requêtes dépassée