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
}
管理 API — 分析与套餐
当前套餐
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_SANDBOX)配额的 Management API 密钥,以原始 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
账户上存档的付款方式,如果未设置任何付款方式(例如 Free Trial/Enterprise 预配置账户),则为
null。object | null
购买此套餐时所依据的具体定价/账单周期记录(
{id, name, period},如果能从订单历史中解析出来,还会附带 amount/currency),如果账户在此套餐下没有任何账单历史,则为 null。object
套餐定义本身。
显示 plan 属性
显示 plan 属性
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_API、INTEGRATION_ZAPIER、INTEGRATION_MCP)。 - 创建一个 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