Utilisation
Surveillez le quota abonnement, le pack ponctuel et les crédits en temps réel.
Le point d'accès Usage retourne votre quota abonnement, pack ponctuel, crédits, limites de débit et détails de clé API. Il ne consomme aucun crédit.
Note : l'objet subscription reflète le quota combiné (quota abonnement + packs restants), pas la part abonnement seule. Le panneau Utilisation API du tableau de bord affiche les trois soldes séparément.
Ce point d'accès est gratuit. Il ne consomme jamais de crédit.
Requête
curl "https://api.chartquery.com/v1/usage" \
-H "x-api-key: YOUR_API_KEY"Les trois soldes
Chaque appel puise dans jusqu'à trois soldes, toujours dans cet ordre. La réponse détaille chacun séparément pour que vous sachiez d'où viennent vos crédits.
- Quota abonnement (
subscription) : appels inclus dans le plan. Remis à zéro à chaque période de facturation (period,renewal_date). - Pack ponctuel (
packs) : packs API ponctuels, jamais remis à zéro, consommés dans l'ordre d'achat après le quota abonnement.packs.currentest le pack utilisé maintenant. Sans plan mensuel,subscriptionreporte la somme de tous les packs. - Crédits (
credits) : utilisés seulement après épuisement du quota abonnement et du pack ponctuel. Facturés séparément.
remaining est le total encore disponible sur les trois soldes, et total_used le total consommé. Quand remaining atteint 0, les appels renvoient 402 jusqu'à l'ajout d'un pack ou de crédits.
Champs de réponse
| Champ | Type | Description |
|---|---|---|
remaining | integer | Total encore disponible sur les trois soldes (quota abonnement + pack ponctuel + crédits) |
total_used | integer | Total consommé sur les trois soldes (la consommation des packs persiste entre périodes) |
renewal_date | string | Date de renouvellement de l'abonnement (ISO 8601) |
period.start | string | Début de la période de facturation actuelle |
period.end | string | Fin de la période de facturation actuelle |
subscription.used | integer | Appels API utilisés sur le quota abonnement + packs combinés |
subscription.total | integer | Plafond combiné (quota abonnement + packs) |
subscription.remaining | integer | Reste combiné (quota abonnement + packs) |
subscription.percent_used | number | Pourcentage du quota abonnement + packs consommé |
credits.given | integer | Crédits accordés (solde séparé) |
credits.consumed | integer | Crédits consommés |
credits.remaining | integer | Crédits restants |
rate_limit.per_minute | integer | null | Limite de requêtes par minute (null = illimité) |
rate_limit.per_second | integer | null | Limite de requêtes par seconde (null = illimité) |
account.name | string | Nom du compte |
account.slug | string | Identifiant du compte |
api_key.alias | string | Nom convivial de la clé API |
api_key.active | boolean | Si la clé est actuellement active |
api_key.category | string | Catégorie de la clé (ex. development, production) |
api_key.expires | string | null | Date d'expiration de la clé (null = n'expire jamais) |
api_key.quotas | object | Quotas personnalisés par clé : total, daily, weekly, monthly |
packs | object | null | Packs API ponctuels, pack par pack (null si le compte n'en a aucun). Pour un compte sans abonnement mensuel, subscription.total est la somme de tous les packs |
packs.count | integer | Nombre de packs actifs |
packs.exhausted_count | integer | Nombre de packs entièrement consommés |
packs.total | integer | Crédits accordés par l'ensemble des packs actifs |
packs.used | integer | Crédits consommés sur l'ensemble des packs |
packs.remaining | integer | Crédits restants sur l'ensemble des packs |
packs.current | object | null | Le pack ponctuel de consommation (les packs sont utilisés dans l'ordre d'achat) ; null quand tous sont épuisés |
packs.items[] | object[] | Chaque pack actif : id, title, purchased_at, total, used, remaining, percent_used, exhausted |
Exemple de réponse
{
"remaining": 450,
"total_used": 1550,
"renewal_date": "2026-04-25",
"period": {
"start": "2026-03-25",
"end": "2026-04-25"
},
"subscription": {
"used": 1550,
"total": 2000,
"remaining": 450,
"percent_used": 77
},
"packs": {
"count": 2,
"exhausted_count": 1,
"all_exhausted": false,
"total": 25000000,
"used": 15200000,
"remaining": 9800000,
"percent_used": 60.8,
"current_index": 2,
"current": {
"id": "cm…",
"title": "Ultimate",
"purchased_at": "2026-02-07",
"total": 12500000,
"used": 2700000,
"remaining": 9800000,
"percent_used": 21.6,
"exhausted": false
},
"items": [
{ "id": "cm…", "title": "Ultimate", "purchased_at": "2025-11-10", "total": 12500000, "used": 12500000, "remaining": 0, "percent_used": 100, "exhausted": true },
{ "id": "cm…", "title": "Ultimate", "purchased_at": "2026-02-07", "total": 12500000, "used": 2700000, "remaining": 9800000, "percent_used": 21.6, "exhausted": false }
]
},
"credits": {
"given": 0,
"consumed": 0,
"remaining": 0,
"percent_used": 0
},
"rate_limit": {
"per_minute": null,
"per_second": null
},
"account": {
"name": "Acme Corp",
"slug": "acme-corp"
},
"api_key": {
"alias": "production",
"active": true,
"category": "production",
"expires": null,
"quotas": {
"total": null,
"daily": null,
"weekly": null,
"monthly": null
}
}
}Voir aussi : Stats pour la santé d'infrastructure de la plateforme sur la dernière heure. Ce n'est pas l'usage de votre compte.