Fecify-套餐-列表

接口信息

  • 接口地址: {your-site-url}/api/skill/addons/package-list
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
  • 请求方式: GET
  • Content-Type: application/json
  • 说明: 获取套餐分页列表。套餐是将系统插件和模版组合在一起，店铺创建时绑定套餐后自动拥有套餐内的插件、模版和多语言配置。

认证

请求头中需要携带 skill-access-token：

Header 值
skill-access-token {your-skill-access-token} （请替换为你自己的 token）

请求参数

参数 类型 必填 说明
pageNum Number 否 当前页码，默认 1
pageSize Number 否 每页条数，默认 20

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/addons/package-list?pageNum=1&pageSize=4' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 25,
                "weight": 1,
                "shop_type": 10,
                "title": {
                    "cn": "一年套餐",
                    "en": "",
                    "tw": ""
                },
                "price_info": [
                    {
                        "id": "r06WBjYE5Z",
                        "is_forever": 2,
                        "days": 30,
                        "day_label": "1月",
                        "price": 20,
                        "compare_at_price": 50
                    }
                ],
                "shop_count": 0,
                "status": 1,
                "type": 1,
                "product_max_count": 0,
                "begin_price": 20,
                "end_price": 20
            }
        ],
        "total": 20,
        "pageSize": 4,
        "totalPage": 5
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码，200 表示成功
message String 执行结果的文字描述
data Object 返回数据

data 子字段

字段 类型 说明
list Array 套餐列表
total Number 总记录数
pageSize Number 每页条数
totalPage Number 总页数

list 子项

字段 类型 说明
id Number 套餐 ID
weight Number 套餐权重，数字越大商家端展示顺序越靠前
shop_type Number 店铺类型：10 B2C，20 B2B
title Object 套餐名称（多语言 JSON）
price_info Array 售价信息数组
shop_count Number 使用该套餐创建的店铺个数
status Number 状态：1 开启，2 关闭
type Number 套餐类型：1 付费套餐，2 体验套餐
product_max_count Number 店铺产品最大数，0 不限制
begin_price Number 起始价格
end_price Number 结束价格

注意事项

  1. title 为多语言 JSON 结构，需根据当前语言获取对应值。
  2. begin_price 和 end_price 为列表展示用价格区间。

results matching ""

    No results matching ""