Product Collection List API 文档

得到专辑列表

接口信息

接口地址: {your-site-url}/api/skill/product-collection/list
基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
请求方式: POST
Content-Type: application/json
说明: 此接口为查询接口，用于获取专辑列表

认证

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

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

请求参数 (Query String)

字段	类型	必填	说明
`pageNum`	int	选填	第几页，不填写则默认第 1 页
`pageSize`	int	选填	每页的数据个数，不填写则默认 20
`title`	string	选填	通过专辑标题进行模糊搜索
`type`	int	选填	专辑类型。`1` 手动专辑，`2` 自动专辑
`created_at_begin`	string	选填	创建时间过滤区间下限，格式：`2016-01-01 00:00:00`
`created_at_end`	string	选填	创建时间过滤区间上限，格式：`2016-01-01 00:00:00`

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/product-collection/list?pageNum=1&pageSize=20&title=Outdoor&type=1&created_at_begin=2026-01-01 00:00:00&created_at_end=2026-12-31 23:59:59' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 363,
                "handle": "sea-sand-dress",
                "image": "/category/15/image/2026/05/11/e1d10f74dbff13c7ae596a008bc5f876.jpg",
                "title": "Sea Sand Dress",
                "body_html": "<p>Discover our Sea Sand Dress collection...</p>",
                "meta_title": "Sea Sand Dress - Beach Dresses & Summer Resort Wear",
                "meta_keywords": "sea sand dress, beach dress, summer dress",
                "meta_description": "Shop the Sea Sand Dress collection...",
                "created_at": "2026-05-11 12:12:20",
                "updated_at": "2026-05-11 12:52:58",
                "type": 1
            }
        ],
        "total": 155,
        "pageSize": 20,
        "totalPage": 8
    },
    "message": "success"
}

返回字段说明

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

data 顶层字段

字段	类型	说明
`total`	int	列表总数
`pageSize`	int	每页的数据个数
`totalPage`	int	总页数
`list`	Array[Object]	专辑列表

data.list 子项

字段	类型	说明
`id`	int	专辑 ID
`type`	int	专辑类型。`1` 手动专辑，`2` 自动专辑
`title`	string	专辑标题
`handle`	string	专辑 URL handle
`image`	string	PC 端专辑图片 URL
`body_html`	string	专辑描述（HTML）
`meta_title`	string	SEO 标题
`meta_keywords`	string	SEO 关键字
`meta_description`	string	SEO 描述
`created_at`	string	创建时间
`updated_at`	string	更新时间

注意事项

所有请求参数均为选填
created_at_begin 和 created_at_end 可单独或组合使用，用于按创建时间区间过滤
时间格式必须为 YYYY-MM-DD HH:mm:ss

results matching ""

No results matching ""