Passer au contenu principal
POST
/
api
/
v1
/
UsageConfig
Définir la configuration d’utilisation
curl --request POST \
  --url https://server.codeium.com/api/v1/UsageConfig \
  --header 'Content-Type: application/json' \
  --data '{
  "service_key": "<string>",
  "clear_add_on_credit_cap": true,
  "set_add_on_credit_cap": 123,
  "team_level": true,
  "group_id": "<string>",
  "user_email": "<string>"
}'

​
Présentation

Définissez ou réinitialisez des plafonds d’utilisation sur les crédits d’add-on pour votre organisation. Vous pouvez appliquer ces paramètres au niveau de l’équipe, de groupes spécifiques ou d’utilisateurs individuels.

​
Requête

​
service_key
string
required
Votre clé de service avec les autorisations appropriées

​
Configuration du plafond de crédits (choisissez une option)

​
clear_add_on_credit_cap
boolean
Définissez sur true pour réinitialiser le plafond de crédits de l’add-on existant
​
set_add_on_credit_cap
integer
Définissez un nouveau plafond de crédits pour l’add-on (valeur entière)
Vous devez fournir soit clear_add_on_credit_cap, soit set_add_on_credit_cap, mais pas les deux.

​
Configuration de la portée (Choisir une option)

​
team_level
boolean
Définissez sur true pour appliquer la configuration au niveau de l’équipe
​
group_id
string
Appliquez la configuration à un groupe spécifique en indiquant l’ID du groupe
​
user_email
string
Appliquez la configuration à un utilisateur spécifique en indiquant son adresse e‑mail
Vous devez fournir l’un de team_level, group_id ou user_email pour définir la portée.

​
Exemple de requête – Définir le plafond de crédits pour l’équipe

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "votre_clé_de_service_ici",
  "set_add_on_credit_cap": 10000,
  "team_level": true
}' \
https://server.codeium.com/api/v1/UsageConfig

​
Exemple de requête - Définir le plafond de crédits d’un groupe

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "set_add_on_credit_cap": 5000,
  "group_id": "engineering_team"
}' \
https://server.codeium.com/api/v1/UsageConfig

​
Exemple de requête - Définir un plafond de crédits pour un utilisateur

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "votre_service_key_ici",
  "set_add_on_credit_cap": 1000,
  "user_email": "utilisateur@exemple.com"
}' \
https://server.codeium.com/api/v1/UsageConfig

​
Exemple de requête – Effacer le plafond de crédits

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "votre_service_key_ici",
  "clear_add_on_credit_cap": true,
  "team_level": true
}' \
https://server.codeium.com/api/v1/UsageConfig

​
Réponse

Le corps de la réponse est vide. Un code d’état 200 indique que l’opération a réussi.

​
Réponses d’erreur

Scénarios d’erreur courants :
  • Clé de service invalide ou autorisations insuffisantes
  • clear_add_on_credit_cap et set_add_on_credit_cap tous deux fournis
  • Ni clear_add_on_credit_cap ni set_add_on_credit_cap fourni
  • Plusieurs paramètres de scope fournis
  • Aucun paramètre de scope fourni
  • ID de groupe ou adresse e‑mail utilisateur invalide
  • Limite de taux dépassée