requête d'utilisation du jeton

Ce qu'il fait

Récupérer l'utilisation actuelle du quota du jeton Bearer: total accordé, utilisé, disponible, drapeau illimité, limites de modèle et délai d'expiration.

📮 Point de terminaison

GET /api/usage/token

Nécessite un en-tête d'autorisation
Renvoie les informations d'utilisation pour le jeton utilisé dans la requête en cours

🔐 Authentification

Incluez l'en-tête suivant pour l'authentification par clé API:

Authorization: Bearer $API_KEY

Le préfixe sk- est accepté mais facultatif ; le serveur le normalise
L'en-tête d'autorisation manquant ou invalide renvoie 401

💡 Exemple de demande

curl -X GET https://88api.ai/api/usage/token \
  -H "Authorization: Bearer $API_KEY"

✅ Exemple de réponse réussie

{
  "code": true,
  "message": "ok",
  "data": {
    "object": "token_usage",
    "name": "Default Token",
    "total_granted": 1000000,
    "total_used": 12345,
    "total_available": 987655,
    "unlimited_quota": false,
    "model_limits": {
      "gpt-4o-mini": true
    },
    "model_limits_enabled": false,
    "expires_at": 0
  }
}

❗ Exemples de réponses d'erreur

En-tête d'autorisation manquant:

{
  "success": false,
  "message": "No Authorization header"
}

Régime invalide (non-Porteur) :

{
  "success": false,
  "message": "Invalid Bearer token"
}

Échec de la récupération du jeton (par exemple, invalide ou supprimé):

{
  "success": false,
  "message": "token not found"
}

🧾 Descriptions des champs (données)

object: toujours token_usage
name: Nom du jeton
total_granted : Total accordé (= utilisé + disponible)
total_used: Quota utilisé
total_available: Quota disponible restant
unlimited_quota: indique si le token a un quota illimité
model_limits: Liste des modèles autorisés
model_limits_enabled: si les limites spécifiques au modèle sont activées
expires_at: Horodatage Unix d'expiration en secondes. 0 signifie n'expire jamais (le backend normalise -1 → 0).

Référence : GET /api/usage/token ajouté dans PR #1161