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
}
Management-API — Token & Nutzung
Nutzungsstatistiken
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
}
Gibt Gesamtanfragenzahlen für ein bestimmtes Schlüssel-Environment über ein rollierendes Zeitfenster zurück. Wie die anderen
Ein ungültiges
console/-Endpunkte befindet sich dies auf dem regulären Scanova-API-Host (qcg-api.scanova.io), authentifiziert mit Ihrem Dashboard-OAuth-Access-Token.
Die Zahlen werden über alle Schlüssel aggregiert, die sich das angegebene
environment in Ihrem Konto teilen, nicht für einen einzelnen Schlüssel. Wenn Sie den Lebenszeit-Gesamtwert eines einzelnen Schlüssels möchten, ist das das Feld usage_count, das von GET /console/token/ zurückgegeben wird.Anfrage
GET https://qcg-api.scanova.io/console/usage/
Authorization: Bearer <your_oauth_access_token>
string
erforderlich
Einer von
sandbox, live, zapier, mcp. Wählt aus, welche Schlüssel-Logs aggregiert werden.string
Standard:"week"
Einer von
day, week, month, year. Das bis jetzt rollierende Zeitfenster, über das Anfragen gezählt werden.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
}
Antwortfelder
integer
Gesamtzahl der protokollierten Anfragen für Schlüssel in diesem Environment innerhalb des Zeitfensters.
integer
Anfragen, die einen Statuscode unter
400 zurückgegeben haben.integer
Anfragen, die einen Statuscode von
400 oder darüber zurückgegeben haben.Fehler
environment ist erforderlich — wird es weggelassen oder ein Wert außerhalb der oben genannten vier angegeben, wird Folgendes zurückgegeben:
400 Bad Request
{ "environment": ["A valid environment is required."] }
period gibt Folgendes zurück:
400 Bad Request
{ "period": ["period must be one of day, week, month, year."] }
Derzeit werden für die Management API keine Rate-Limits durchgesetzt — diese Nutzungs-Endpunkte existieren rein zur Transparenz, nicht zur Überwachung einer Quota. Siehe Tägliche Nutzung für einen Trend pro Tag und Nutzung nach Endpunkt für eine Aufschlüsselung nach Route.
Verwandte Themen
- Tägliche Nutzung — dieselben Zahlen, aufgeschlüsselt nach Kalendertag.
- Nutzung nach Endpunkt — dieselben Zahlen, aufgeschlüsselt nach Route und Methode.
- Ein API-Token erstellen — woher das Lebenszeit-Feld
usage_countpro Schlüssel (zu unterscheiden von diesen environment-weiten Gesamtwerten) stammt.
Autorisierungen
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.
Abfrageparameter
Verfügbare Optionen:
day, week, month, year Antwort
200
Usage stats
War diese Seite hilfreich?
⌘I