套餐卡

查询站点当前启用且可购买/兑换的套餐卡列表，用于渲染套餐选购页面。

GET/api/package-cards

无需鉴权，返回管理接口风格的 {"success", "message", "data"} 信封。只返回已启用（status 为启用）且标记为可购买（purchasable=true）、非「无套餐」的套餐卡，按等级由低到高排序。管理员在后台创建但未启用、或标记为不可购买的套餐卡不会出现在此列表中。

curl https://api.jimu.chat/api/package-cards

import requests

cards = requests.get("https://api.jimu.chat/api/package-cards").json()["data"]
for card in cards:
    print(card["name"], card["package_code"], card["price_amount"])

const { data } = await fetch("https://api.jimu.chat/api/package-cards").then((r) => r.json());
console.log(data.map((c: any) => ({ name: c.name, code: c.package_code, price: c.price_amount })));

响应200

{
  "success": true,
  "message": "",
  "data": [
    {
      "id": 5,
      "package_code": "pro",
      "name": "Pro 套餐",
      "description": "适合中等用量的个人开发者",
      "level": 10,
      "price_amount": 29,
      "system_builtin": false,
      "purchasable": true,
      "daily_quota": 100000,
      "duration_days": 30,
      "refresh_interval_seconds": 0,
      "interval_quota": 0,
      "weekly_quota_limit": 0,
      "status": 1,
      "created_time": 1756400000
    }
  ]
}

套餐卡对象

idint

套餐卡 ID

package_codestring

套餐权限标识，兑换/激活后写入用户的 current_package_code

namestring

套餐展示名称

descriptionstring

套餐描述文案

levelint

套餐等级，用于升降级判断；数值越大等级越高

price_amountfloat

展示价格，单位跟随站点货币展示配置

purchasablebool

是否在用户端展示为可购买/可兑换；本接口只返回 true 的记录

daily_quotaint

每日额度（refresh_interval_seconds=0 时按此值每日刷新）

duration_daysint

套餐有效期（天）

refresh_interval_secondsint

自定义刷新周期（秒）；0 表示按自然日每日刷新

购买/兑换套餐卡本身通过充值的兑换码链路完成（type=package 的兑换码绑定某个 package_card_id），本接口只负责展示可选套餐列表，不提供直接下单能力。

充值

查询充值方式与档位配置、查询本人充值/兑换记录、预览与执行兑换码兑换。