Skip to main content
GET
返回已通过身份验证的账户的当前有效订阅套餐——其到期时间、账单状态,以及该套餐授予的完整配额/权限集合。
需要一个拥有 MANAGEMENT_API(或 MANAGEMENT_API_SANDBOX)配额的 Management API 密钥,以原始 Authorization 请求头的值发送——参见 Management API 概览

请求

已针对一个 Pro 套餐测试账户完成线上核实——该账户的 pricingpayment_method 均为 null,因为它目前并非处于付费的循环账单周期中;plan.quotas 在上方为求简洁而做了截断(真实响应会包含该套餐授予的每一项配额)。

响应字段

boolean
套餐当前是否处于有效状态(未过期、未取消)。
boolean
是否为免费层级套餐。
string
到期日期(YYYY-MM-DD),对于没有到期时间的套餐,则为字面字符串 "Lifetime"
boolean
该套餐是否已经过期。
integer
距离 expire 剩余的天数。
boolean
是否开启了自动续订。
boolean
该账户是否有资格从仪表盘取消其订阅。
object | null
账户上存档的付款方式,如果未设置任何付款方式(例如 Free Trial/Enterprise 预配置账户),则为 null
object | null
购买此套餐时所依据的具体定价/账单周期记录({id, name, period},如果能从订单历史中解析出来,还会附带 amount/currency),如果账户在此套餐下没有任何账单历史,则为 null
object
套餐定义本身。
object | null
如果账户有一个计划中的套餐变更(例如在当前账单周期结束时生效的降级),则形状与 plan 相同——否则为 null
标准 Pro 套餐授予 MANAGEMENT_API 配额——在已核实的测试环境中,只有 Free Trial、Enterprise 和 Internal 套餐才授予该配额。如果您正在基于此 API 进行开发,并遇到附带 "Your plan does not have management API quota." 消息的 401 错误,请在此处的 plan.quotas 中检查是否有 MANAGEMENT_API(或 MANAGEMENT_API_SANDBOX);如果您认为自己的套餐应当包含该配额,请联系支持团队——目前该特定配额没有自助升级路径。

相关内容

  • Management API 概览 —— 本端点 plan.quotas 中的代号(codename)所对应的 environment 到配额映射关系(MANAGEMENT_APIINTEGRATION_ZAPIERINTEGRATION_MCP)。
  • 创建一个 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.