curl "https://api.scanova.io/plans/downgrade-impact/?target_plan=starter-scanova-io" \
-H "Authorization: YOUR_API_KEY"
{
"violations": [
{
"codename": "TOTAL_QR_CODES",
"quota_name": "Total QR Codes",
"exceed_value": 12,
"resolvable": true,
"total_affected_count": 112,
"affected_resources": ["Q07afe81aa0034c01", "Q19bd72cc1145d02"]
}
],
"current_plan_expiry": "2027-08-16",
"days_remaining": 365
}
Analysen & Tarife
Auswirkung eines Tarif-Downgrades prüfen
GET /plans/downgrade-impact/
GET
/
plans
/
downgrade-impact
/
curl "https://api.scanova.io/plans/downgrade-impact/?target_plan=starter-scanova-io" \
-H "Authorization: YOUR_API_KEY"
{
"violations": [
{
"codename": "TOTAL_QR_CODES",
"quota_name": "Total QR Codes",
"exceed_value": 12,
"resolvable": true,
"total_affected_count": 112,
"affected_resources": ["Q07afe81aa0034c01", "Q19bd72cc1145d02"]
}
],
"current_plan_expiry": "2027-08-16",
"days_remaining": 365
}
Zeigt vorab, welche Ressourcen ein Downgrade blockieren würden, bevor Sie zur Kasse gehen, auf dem Management-API-Host (
Ein leeres
api.scanova.io), authentifiziert mit Ihrem rohen Management-API-Schlüssel.
GET https://api.scanova.io/plans/downgrade-impact/
Authorization: YOUR_API_KEY
string
erforderlich
Der Slug des Zieltarifs (aus dem
slug-Feld von Verfügbare Tarife auflisten).curl "https://api.scanova.io/plans/downgrade-impact/?target_plan=starter-scanova-io" \
-H "Authorization: YOUR_API_KEY"
{
"violations": [
{
"codename": "TOTAL_QR_CODES",
"quota_name": "Total QR Codes",
"exceed_value": 12,
"resolvable": true,
"total_affected_count": 112,
"affected_resources": ["Q07afe81aa0034c01", "Q19bd72cc1145d02"]
}
],
"current_plan_expiry": "2027-08-16",
"days_remaining": 365
}
violations-Array bedeutet, dass das Downgrade derzeit unproblematisch ist — nichts müsste vorher geändert werden. Dies ist vollständig schreibgeschützt und ändert nichts; es verwendet exakt dieselbe Regel-Engine, die auch der echte Checkout durchsetzt, kann also nicht von dem abweichen, was bei einem tatsächlichen Downgrade passiert.
Antwortfelder
array
Ein Eintrag pro Quota, die der Zieltarif angesichts der aktuellen Nutzung des Kontos nicht abdecken kann.
Anzeigen Eigenschaften von violation
Anzeigen Eigenschaften von violation
string
Der stabile Bezeichner der Quota (z. B.
TOTAL_QR_CODES, SHARED_USERS).string
Menschenlesbarer Quota-Name.
integer
Wie weit das Konto derzeit über dem Limit des Zieltarifs liegt.
boolean
Ob das Konto dies selbst lösen kann (z. B. durch Löschen/Deaktivieren einiger Ressourcen), bevor es downgradet.
integer
Gesamtzahl der auf diese Quota angerechneten Ressourcen.
array
Bezeichner der konkreten gezählten Ressourcen (z. B. QR-
qrid-Werte) — kann bei hohen Zahlen eine gekürzte Stichprobe sein.string
Das Ablaufdatum des aktuellen Tarifs, oder
null bei einem Tarif ohne Ablaufdatum.integer | null
Verbleibende Tage bis
current_plan_expiry, oder null, wenn der Tarif kein Ablaufdatum hat.400, wenn target_plan fehlt.
Siehe auch
- Verfügbare Tarife auflisten — einen
slugfinden, für den ein Downgrade geprüft werden soll. - Aktueller Tarif — der aktuelle Tarif und die Quota-Zuweisungen des Kontos.
- Management-API-Übersicht — das Auth-Schema und die Quota-Regeln, die für diesen Endpunkt gelten.
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: YOUR_API_KEY. 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. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Abfrageparameter
The target plan's slug.
Antwort
Violations that would block the downgrade (empty array if none), plus the current plan's remaining time.
War diese Seite hilfreich?