Blog Collection Get Article List API 文档

博客专辑-得到文章列表

接口信息

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

认证

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

请求参数 (Query String)

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/blog-collection/get-collect-article-list?collection_id=127&pageNum=1&pageSize=20' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 815,
                "shop_id": 15,
                "article_id": 473,
                "position": null,
                "article": {
                    "id": 473,
                    "shop_id": 15,
                    "user_id": 0,
                    "author": "yu zhang",
                    "handle": "fecify-article-3-m49fsg6u",
                    "title": "封面在顶部",
                    "summary_html": "",
                    "body_html": "<p>fecify article 3</p>",
                    "meta_title": "封面在顶部",
                    "meta_keywords": "",
                    "meta_description": "fecify article 3",
                    "meta_is_edit": 1,
                    "translate_type": 3,
                    "image": "/blog_article/15/image/2026/02/08/...",
                    "width": 1024,
                    "height": 1024,
                    "ratio": "1.00",
                    "is_published": 1,
                    "published_at": 1770560348,
                    "created_at": 1778492400,
                    "updated_at": 1778493462,
                    "remote_id": "",
                    "product_id": 0,
                    "product_ids": "",
                    "description_json_status": 2,
                    "description_json": "",
                    "image_show_type": 1,
                    "template_type": ""
                }
            }
        ],
        "total": 20,
        "pageSize": 20,
        "totalPage": 1
    },
    "message": "success"
}

返回字段说明

data 顶层字段

data.list 子项

article 对象

注意事项

1. collection_id 为必填
2. pageNum 和 pageSize 为选填，用于分页
3. position 为 null 表示该文章在专辑中未设置排序位置