Blog Article List API 文档

博客文章-列表

接口信息

• 接口地址: {your-site-url}/api/skill/blog-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-article/list?pageNum=1&pageSize=20&title=cover&is_published=1' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 474,
                "shop_id": 15,
                "user_id": 0,
                "author": "yu zhang",
                "handle": "fecify-article-3-bfdce56m",
                "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/3443b7accccc9b7f1bb993b23e2f7bdd.webp",
                "width": 1024,
                "height": 1024,
                "ratio": "1.00",
                "is_published": 1,
                "published_at": "2026-02-08 22:19:08",
                "created_at": "2026-05-11 17:56:51",
                "updated_at": "2026-05-11 17:56:51",
                "remote_id": "",
                "product_id": 0,
                "product_ids": "",
                "description_json_status": 2,
                "description_json": "",
                "image_show_type": 1,
                "template_type": ""
            }
        ],
        "total": 108,
        "pageSize": 20,
        "totalPage": 6
    },
    "message": "success"
}

返回字段说明

data 顶层字段

data.list 子项

注意事项

1. 所有请求参数均为选填
2. is_published 可选值：1 已发布，2 未发布