curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
API de gestion — Jetons et utilisation
Utilisation par endpoint
GET /console/usage/by-endpoint/
GET
/
console
/
usage
/
by-endpoint
/
curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
Renvoie le nombre de requêtes regroupées par endpoint et méthode HTTP — utile pour voir quelles parties de la Management API une intégration exerce réellement. 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.
Requête
GET https://qcg-api.scanova.io/console/usage/by-endpoint/
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.curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
Champs de réponse
La réponse est un tableau, une entrée par paire distincte(endpoint, method) observée dans les journaux, triée par count décroissant.
string
L’URL complète de la requête telle qu’enregistrée, y compris la valeur réelle du paramètre de chemin (par ex. un
qrid spécifique) — et non un modèle de route normalisé. Attendez-vous à de nombreuses entrées distinctes pour les routes paramétrées par chemin si vous les avez appelées avec différents identifiants.string
La méthode HTTP de la requête, par ex.
GET, POST, PUT, DELETE.integer
Nombre total de requêtes enregistrées pour cette paire endpoint/méthode.
number
Fraction (
0–1) des requêtes vers cette paire endpoint/méthode ayant renvoyé un code de statut de 400 ou plus.Contrairement à Statistiques d’utilisation et Utilisation quotidienne, cet endpoint n’a pas de fenêtre
period/days — il agrège sur toute la période de conservation des journaux (les journaux de requêtes sont purgés après 6 mois).Erreurs
environment est obligatoire, même validation que Statistiques d’utilisation.
Voir aussi
- Statistiques d’utilisation — le même trafic sous forme d’un total unique sur fenêtre glissante plutôt qu’une répartition par endpoint.
- Utilisation quotidienne — le même trafic réparti par jour civil plutôt que par route.
- Vue d’ensemble de la Management API — les valeurs
environment(sandbox,live,zapier,mcp) selon lesquelles cet endpoint agrège.
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
Réponse
200
Usage grouped by endpoint
Cette page vous a-t-elle été utile ?
⌘I