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>"
}
'

​
Vue d’ensemble

Définissez ou réinitialisez des plafonds d’utilisation par utilisateur sur les crédits d’add-on pour votre organisation. Les plafonds sont toujours appliqués par utilisateur. Lorsque vous spécifiez une portée d’équipe ou de groupe, le plafond est appliqué individuellement à chaque utilisateur au sein de cette équipe ou de ce groupe — il ne définit pas un plafond partagé pour l’ensemble de l’équipe ou du groupe.

​
Requête

​
service_key
string
requis
Votre clé de service avec les autorisations « Facturation Write »

​
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 le plafond par utilisateur à tous les utilisateurs de l’équipe
​
group_id
string
Appliquez le plafond par utilisateur à tous les utilisateurs d’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 par utilisateur pour tous les membres de l’équipe

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "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édit individuel pour tous les membres 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édit pour un utilisateur

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

​
Exemple de requête - Suppression du plafond de crédits

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "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 HTTP 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