curl -G "https://qcg-api.scanova.io/console/usage/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live \
-d period=month
{
"total_requests": 4820,
"successful_requests": 4761,
"failed_requests": 59
}
API de gestion — Jetons et utilisation
Statistiques d'utilisation
GET /console/usage/
GET
/
console
/
usage
/
curl -G "https://qcg-api.scanova.io/console/usage/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live \
-d period=month
{
"total_requests": 4820,
"successful_requests": 4761,
"failed_requests": 59
}
Renvoie les totaux du nombre de requêtes pour un environnement de clé donné sur une fenêtre glissante. Comme les autres endpoints
Une valeur
console/, celui-ci se trouve sur l’hôte habituel de l’API Scanova (qcg-api.scanova.io), authentifié avec votre token d’accès OAuth du tableau de bord.
Les chiffres sont agrégés sur toutes les clés partageant l’
environment donné de votre compte, et non une clé unique. Si vous souhaitez le total à vie d’une seule clé, il s’agit du champ usage_count renvoyé par GET /console/token/.Requête
GET https://qcg-api.scanova.io/console/usage/
Authorization: Bearer <your_oauth_access_token>
string
requis
L’un de
sandbox, live, zapier, mcp. Sélectionne les journaux de quelles clés agréger.string
défaut:"week"
L’un de
day, week, month, year. La fenêtre glissante se terminant maintenant sur laquelle les requêtes sont comptabilisées.curl -G "https://qcg-api.scanova.io/console/usage/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live \
-d period=month
{
"total_requests": 4820,
"successful_requests": 4761,
"failed_requests": 59
}
Champs de réponse
integer
Nombre total de requêtes enregistrées pour les clés de cet environnement dans la fenêtre.
integer
Requêtes ayant renvoyé un code de statut inférieur à
400.integer
Requêtes ayant renvoyé un code de statut de
400 ou plus.Erreurs
environment est obligatoire — l’omettre, ou transmettre une valeur en dehors des quatre listées ci-dessus, renvoie :
400 Bad Request
{ "environment": ["A valid environment is required."] }
period invalide renvoie :
400 Bad Request
{ "period": ["period must be one of day, week, month, year."] }
Aucune limite de débit n’est actuellement appliquée sur la Management API — ces endpoints d’utilisation existent uniquement à des fins de visibilité, et non pour surveiller un quota. Voir Utilisation quotidienne pour une tendance par jour et Utilisation par endpoint pour une répartition par route.
Voir aussi
- Utilisation quotidienne — les mêmes chiffres, répartis par jour civil.
- Utilisation par endpoint — les mêmes chiffres, répartis par route et méthode.
- Créer un token API — d’où provient le champ
usage_countà vie par clé (distinct de ces totaux à l’échelle de l’environnement).
Autorisations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Paramètres de requête
Options disponibles:
day, week, month, year Réponse
200
Usage stats
Cette page vous a-t-elle été utile ?
⌘I