Page List API 文档

自定义页面-列表

接口信息

接口地址: {your-site-url}/api/skill/page/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	选填	每页的数据个数，不填写则使用系统默认值
`title`	string	选填	通过页面标题进行模糊搜索
`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/page/list?pageNum=1&pageSize=20&title=about&created_at_begin=2025-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": 385,
                "shop_id": 15,
                "handle": "112233",
                "is_title_show": 1,
                "title": "112233",
                "meta_title": "112233",
                "meta_keywords": "",
                "meta_description": "RECOMMEND PRODUCTS. EARN COMMISSIONS...",
                "template_type": "page.faqs",
                "created_at": "2026-05-08 11:32:14",
                "updated_at": "2026-05-11 16:03:05"
            }
        ],
        "total": 74,
        "pageSize": 20,
        "totalPage": 4
    },
    "message": "success"
}

返回字段说明

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

data 顶层字段

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

data.list 子项

字段	类型	说明
`id`	int	页面 ID
`shop_id`	int	店铺 ID
`handle`	string	页面 URL handle
`is_title_show`	int	前台商城是否显示标题。`1` 显示标题，`2` 不显示标题
`title`	string	页面标题
`meta_title`	string	SEO 标题
`meta_keywords`	string	SEO 关键字
`meta_description`	string	SEO 描述
`template_type`	string	Mirox 模板布局样式（如 `page.about-us`、`page.faqs`、`page.company`、`page.find-a-store`）
`created_at`	string	创建时间
`updated_at`	string	更新时间

注意事项

所有请求参数均为选填
created_at_begin 和 created_at_end 可单独或组合使用
时间格式必须为 YYYY-MM-DD HH:mm:ss
template_type 为空表示使用默认模板布局

results matching ""

No results matching ""