Blog Collection List API 文档

博客专辑-列表

接口信息

接口地址: {your-site-url}/api/skill/blog-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	选填	每页的数据个数，不填写则使用系统默认值
`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/blog-collection/list?pageNum=1&pageSize=20&title=fecify&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": 126,
                "shop_id": 15,
                "handle": "blog-article-title",
                "title": "blog article title",
                "body_html": "blog article description",
                "meta_title": "blog article title",
                "meta_is_edit": 2,
                "translate_type": 3,
                "meta_keywords": "blog article",
                "meta_description": "blog article description",
                "updated_at": "2026-05-11 21:20:19",
                "created_at": "2026-05-11 21:20:19",
                "remote_id": "",
                "template_type": "blog_collection",
                "article_count": 0
            }
        ],
        "total": 24,
        "pageSize": 20,
        "totalPage": 2
    },
    "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
`title`	string	专辑标题
`body_html`	string	专辑描述（HTML）
`meta_title`	string	SEO 标题
`meta_keywords`	string	SEO 关键字
`meta_description`	string	SEO 描述
`meta_is_edit`	int	SEO 是否独立编辑。`1` 非独立编辑，`2` 独立编辑
`translate_type`	int	翻译方式。`1` 强制翻译，`2` 只翻译多语言为空的部分，`3` 不翻译
`template_type`	string	Mirox 模板布局样式（如 `blog_collection`、`blog_collection.list`、`blog_collection.grid`）
`article_count`	int	该专辑下的文章数量
`remote_id`	string	远程 ID，一般用于数据同步
`created_at`	string	创建时间
`updated_at`	string	更新时间

注意事项

所有请求参数均为选填
created_at_begin 和 created_at_end 可单独或组合使用
时间格式必须为 YYYY-MM-DD HH:mm:ss
article_count 为该专辑下关联的文章总数

results matching ""

No results matching ""