curl --request GET \
--url 'https://management.scanova.io/plans/current/' \
--header 'Authorization: YOUR_API_KEY'
{
"is_active": true,
"is_free": false,
"expire": "2027-08-16",
"is_expired": false,
"days_left": 365,
"recurring_enabled": false,
"can_cancel_subscription": false,
"payment_method": null,
"pricing": null,
"plan": {
"id": 275,
"slug": "pro-scanova-io",
"name": "Pro - scanova.io",
"plan_type": "Normal",
"description": "...",
"version": 1,
"family": {
"id": 12,
"name": "Pro"
},
"quotas": [
{
"quota_id": 401,
"codename": "QR_CODE_LIMIT",
"name": "QR Code Limit",
"value": 100
}
],
"is_enterprise_plan": false,
"is_custom_plan": false
},
"upcoming_plan": null
}
واجهة الإدارة — التحليلات والخطط
الخطة الحالية
GET /plans/current/
GET
/
plans
/
current
/
curl --request GET \
--url 'https://management.scanova.io/plans/current/' \
--header 'Authorization: YOUR_API_KEY'
{
"is_active": true,
"is_free": false,
"expire": "2027-08-16",
"is_expired": false,
"days_left": 365,
"recurring_enabled": false,
"can_cancel_subscription": false,
"payment_method": null,
"pricing": null,
"plan": {
"id": 275,
"slug": "pro-scanova-io",
"name": "Pro - scanova.io",
"plan_type": "Normal",
"description": "...",
"version": 1,
"family": {
"id": 12,
"name": "Pro"
},
"quotas": [
{
"quota_id": 401,
"codename": "QR_CODE_LIMIT",
"name": "QR Code Limit",
"value": 100
}
],
"is_enterprise_plan": false,
"is_custom_plan": false
},
"upcoming_plan": null
}
يعيد خطة الاشتراك الفعّالة للحساب المصادَق عليه — تاريخ انتهائها، وحالة الفوترة، والمجموعة الكاملة من الحصص والصلاحيات التي تمنحها الخطة.
تم التحقق منه مباشرة مقابل حساب اختباري على خطة Pro —
يتطلب مفتاح Management API بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization — راجع نظرة عامة على Management API.الطلب
curl --request GET \
--url 'https://management.scanova.io/plans/current/' \
--header 'Authorization: YOUR_API_KEY'
{
"is_active": true,
"is_free": false,
"expire": "2027-08-16",
"is_expired": false,
"days_left": 365,
"recurring_enabled": false,
"can_cancel_subscription": false,
"payment_method": null,
"pricing": null,
"plan": {
"id": 275,
"slug": "pro-scanova-io",
"name": "Pro - scanova.io",
"plan_type": "Normal",
"description": "...",
"version": 1,
"family": {
"id": 12,
"name": "Pro"
},
"quotas": [
{
"quota_id": 401,
"codename": "QR_CODE_LIMIT",
"name": "QR Code Limit",
"value": 100
}
],
"is_enterprise_plan": false,
"is_custom_plan": false
},
"upcoming_plan": null
}
pricing وpayment_method هما null في هذا الحساب لأنه ليس حاليًا على دورة فوترة متكررة مدفوعة؛ plan.quotas مختصرة أعلاه للإيجاز (الاستجابة الفعلية تتضمن كل حصة تمنحها الخطة).
حقول الاستجابة
boolean
ما إذا كانت الخطة فعّالة حاليًا (غير منتهية، غير ملغاة).
boolean
ما إذا كانت هذه خطة من المستوى المجاني.
string
تاريخ الانتهاء (
YYYY-MM-DD)، أو السلسلة النصية الحرفية "Lifetime" لخطة بلا انتهاء.boolean
ما إذا كانت الخطة قد انتهت بالفعل.
integer
الأيام المتبقية حتى
expire.boolean
ما إذا كان التجديد التلقائي مفعّلًا.
boolean
ما إذا كان الحساب مؤهلًا لإلغاء اشتراكه من لوحة التحكم.
object | null
طريقة الدفع المسجّلة للحساب، أو
null إذا لم تُحدَّد أي طريقة (مثل الحسابات المزوَّدة عبر Free Trial أو Enterprise).object | null
سجل التسعير/فترة الفوترة المحدد الذي اشتُريت هذه الخطة بموجبه (
{id, name, period}، بالإضافة إلى amount/currency عندما يمكن استنتاجهما من سجل الطلبات)، أو null إذا لم يكن للحساب أي سجل فوترة مقابل هذه الخطة.object
تعريف الخطة نفسه.
إظهار خصائص plan
إظهار خصائص plan
integer
string
string
string
نوع الخطة المقروء للبشر، مثل
Normal، Enterprise.string
integer
object
{id, name} — عائلة الخطط التي تنتمي إليها هذه الخطة (مثلًا كل مستويات “Pro”).array
كل حصة تمنحها هذه الخطة، كل واحدة بصيغة
{quota_id, codename, name, value, ...}. codename هو المعرّف الثابت الذي تشير إليه رسائل خطأ حاجز الحصة في نقاط النهاية الأخرى (مثل MANAGEMENT_API، FOLDER_MANAGEMENT، EXPORT_ANALYTICS_REPORT).boolean
boolean
object | null
نفس شكل
plan، إذا كان للحساب تغيير خطة مجدوَل (مثل تخفيض يسري في نهاية دورة الفوترة الحالية) — وnull خلاف ذلك.خطة Pro القياسية لا تمنح حصة
MANAGEMENT_API — فقط خطط Free Trial وEnterprise وInternal تمنحها في بيئة الاختبار التي تم التحقق منها. إذا كنت تبني على أساس هذه الـ API وتحصل على 401 مع الرسالة "Your plan does not have management API quota."، تحقق من plan.quotas هنا بحثًا عن MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، وتواصل مع الدعم إذا كنت تعتقد أن خطتك ينبغي أن تتضمنها — لا يوجد مسار ترقية ذاتية الخدمة لهذه الحصة تحديدًا في الوقت الحالي.ذات صلة
- نظرة عامة على Management API — تخطيط
environmentإلى الحصة (MANAGEMENT_API،INTEGRATION_ZAPIER،INTEGRATION_MCP) الذي تقابله رموزplan.quotasالخاصة بنقطة النهاية هذه. - إنشاء رمز API — حيث تحدد
environmentالخاصة بالمفتاح أي هذه الحصص يُفحص. - تصدير التحليلات — نقطة نهاية محكومة برمز
EXPORT_ANALYTICS_REPORTيمكنك التحقق منه هنا. - إدارة المجلدات — نقطة نهاية محكومة برمز
FOLDER_MANAGEMENTيمكنك التحقق منه هنا.
التفويضات
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.
الاستجابة
200 - application/json
Current plan detail — expiry, billing state, and the full quota/permission set the plan grants.
هل كانت هذه الصفحة مفيدة؟
⌘I