curl "https://api.scanova.io/plans/downgrade-impact/?target_plan=starter-scanova-io" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"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
}
التحليلات والخطط
معاينة أثر خفض مستوى الخطة
GET /plans/downgrade-impact/
GET
/
plans
/
downgrade-impact
/
curl "https://api.scanova.io/plans/downgrade-impact/?target_plan=starter-scanova-io" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"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
}
يعاين الموارد التي ستعيق خفض مستوى الخطة قبل الالتزام بالدفع، على مضيف Management API (
تعني مصفوفة
يعيد الرد
api.scanova.io)، مصادَقًا عليه بمفتاح Management API الخام الخاص بك.
GET https://api.scanova.io/plans/downgrade-impact/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
مطلوب
slug الخطة المستهدفة (من حقل
slug في سرد الخطط المتاحة).curl "https://api.scanova.io/plans/downgrade-impact/?target_plan=starter-scanova-io" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"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
إدخال واحد لكل حصة لا يمكن للخطة المستهدفة استيعابها بالنظر إلى الاستخدام الحالي للحساب.
إظهار خصائص violation
إظهار خصائص violation
string
المعرّف الثابت للحصة (مثل
TOTAL_QR_CODES، SHARED_USERS).string
اسم الحصة القابل للقراءة البشرية.
integer
مقدار تجاوز الحساب حاليًا لحد الخطة المستهدفة.
boolean
ما إذا كان بإمكان الحساب حل هذا بنفسه (مثل حذف/تعطيل بعض الموارد) قبل خفض المستوى.
integer
العدد الإجمالي للموارد المحسوبة ضمن هذه الحصة.
array
معرّفات الموارد المحدَّدة المحسوبة (مثل قيم
qrid لرموز QR) — قد تكون عيّنة مُختصرة عند الأعداد المرتفعة.string
تاريخ انتهاء الخطة الحالية، أو
null لخطة بلا تاريخ انتهاء.integer | null
الأيام المتبقية حتى
current_plan_expiry، أو null إذا لم يكن للخطة تاريخ انتهاء.400 إذا كانت target_plan مفقودة.
طرق ذات صلة
- سرد الخطط المتاحة — العثور على
slugلمعاينة خفض المستوى إليه. - الخطة الحالية — الخطة الحالية للحساب ومنح الحصص الخاصة به.
- نظرة عامة على Management API — مخطط المصادقة وقواعد الحصة المطبّقة على هذا الطرف.
التفويضات
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. api.scanova.io) — the same key sent to the regular API host will not authenticate.
معلمات الاستعلام
The target plan's slug.
الاستجابة
Violations that would block the downgrade (empty array if none), plus the current plan's remaining time.
هل كانت هذه الصفحة مفيدة؟