Skip to main content
GET
يعيد خطة الاشتراك الفعّالة للحساب المصادَق عليه — تاريخ انتهائها، وحالة الفوترة، والمجموعة الكاملة من الحصص والصلاحيات التي تمنحها الخطة.
يتطلب مفتاح Management API بحصة MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization — راجع نظرة عامة على Management API.

الطلب

تم التحقق منه مباشرة مقابل حساب اختباري على خطة Pro — 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
تعريف الخطة نفسه.
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 يمكنك التحقق منه هنا.

التفويضات

Authorization
string
header
مطلوب

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.