博客专辑

属性

属性名	说明	必填	类型
id		是	number
title	标题	是	string
description	描述	是	string
seo_title	seo标题	是	string
seo_description	seo描述	是	string
seo_slug	seo slug	是	string
created_at		是	string
updated_at		是	string
blogs_count	博客数量	是	number
public_url	预览url	是	string
path	路径	是	string

{
    "meta": {
        "current_page": "当前页码",
        "from": "当前页起始条数号",
        "last_page": "尾页页码",
        "path": "分页基本url",
        "per_page": "每页显示条数",
        "to": "当前页结束条数号",
        "total": "数据总数"
    },
    "links": {
        "first": "首页url",
        "last": "尾页url",
        "prev": "上一页url",
        "next": "下一页url",
        "data": [{
            "id": "",
            "title": "标题",
            "description": "描述",
            "seo_title": "seo标题",
            "seo_description": "seo描述",
            "seo_slug": "seo slug",
            "created_at": "",
            "updated_at": "",
            "blogs_count": "博客数量",
            "public_url": "预览url",
            "path": "路径"
        }]
    }
}

专辑下的博客批量操作

POST /openapi/2025-04/blog_collections/{id}/batch

权限：write_content

Query Parameters

Name	Type	Description
id	String

200: OK

{
    "ids": "博客ids",
    "select_all": "是否选择全部",
    "operate": "操作",
    "filter[status]": "状态",
    "filter[key]": "关键字",
    "end_position": "最终位置，当operate=sort_blogs_manual是必填"
}

专辑下的博客

GET /openapi/2025-04/blog_collections/{id}/blogs

权限：read_content

Query Parameters

Name	Type	Description
id	String	专辑id

200: OK

{
    "meta": {
        "current_page": "当前页码",
        "from": "当前页起始条数号",
        "last_page": "尾页页码",
        "path": "分页基本url",
        "per_page": "每页显示条数",
        "to": "当前页结束条数号",
        "total": "数据总数"
    },
    "links": {
        "first": "首页url",
        "last": "尾页url",
        "prev": "上一页url",
        "next": "下一页url"
    },
    "data": [{
        "id": "",
        "title": "标题",
        "summary": "摘要",
        "content": "内容/正文",
        "cover_id": "封面id",
        "author": "作者",
        "seo_title": "seo标题",
        "seo_description": "seo描述",
        "seo_slug": "seo slug",
        "status": "状态:1-隐藏,2-可见",
        "visible_at": "可见时间",
        "created_at": "创建时间",
        "updated_at": "更新时间",
        "public_url": "预览url",
        "path": "路径",
        "cover": {
            "ID": "",
            "url": "",
            "thumbnail": "",
            "medium": "",
            "big": "",
            "srcset": ""
        }
    }]
}

更新专辑

PUT /openapi/2025-04/blog_collections/{id}

权限：write_content

Query Parameters

Name	Type	Description
id	String	博客专辑id

Request Body

Name	Type	Description
title	String	标题
description	String	描述
seo_title	String	seo标题
seo_description	String	seo描述
seo_slug	String	seo slug
sort_type	String	排序方式

200: OK

{
    "id": "",
    "title": "标题",
    "description": "描述",
    "seo_title": "seo标题",
    "seo_description": "seo描述",
    "seo_slug": "seo slug",
    "created_at": "",
    "updated_at": "",
    "blogs_count": "博客数量",
    "public_url": "预览url",
    "path": "路径"
}

添加专辑

POST /openapi/2025-04/blog_collections

权限：write_content

Request Body

Name	Type	Description
title	String	标题
description	String	描述
seo_title	String	seo标题
seo_description	String	seo描述
seo_slug	String	seo slug
blog_ids	Array	博客集合id
sort_type	String	排序方式

200: OK

{
    "id": "",
    "title": "标题",
    "description": "描述",
    "seo_title": "seo标题",
    "seo_description": "seo描述",
    "seo_slug": "seo slug",
    "created_at": "",
    "updated_at": "",
    "blogs_count": "博客数量",
    "public_url": "预览url",
    "path": "路径"
}

专辑列表

GET /openapi/2025-04/blog_collections

权限：read_content

Query Parameters

Name	Type	Description
filter[key]	String	关键字
include	String	包含关联
sort	String	排序

200: OK

{
    "meta": {
        "current_page": "当前页码",
        "from": "当前页起始条数号",
        "last_page": "尾页页码",
        "path": "分页基本url",
        "per_page": "每页显示条数",
        "to": "当前页结束条数号",
        "total": "数据总数"
    },
    "links": {
        "first": "首页url",
        "last": "尾页url",
        "prev": "上一页url",
        "next": "下一页url",
        "data": [{
            "id": "",
            "title": "标题",
            "description": "描述",
            "seo_title": "seo标题",
            "seo_description": "seo描述",
            "seo_slug": "seo slug",
            "created_at": "",
            "updated_at": "",
            "blogs_count": "博客数量",
            "public_url": "预览url",
            "path": "路径"
        }]
    }
}

专辑详情

GET /openapi/2025-04/blog_collections/{id}

权限：read_content

Query Parameters

Name	Type	Description
id	String	博客专辑id

200: OK

{
    "id": "",
    "title": "标题",
    "description": "描述",
    "seo_title": "seo标题",
    "seo_description": "seo描述",
    "seo_slug": "seo slug",
    "created_at": "",
    "updated_at": "",
    "blogs_count": "博客数量",
    "public_url": "预览url",
    "path": "路径"
}

删除专辑

DELETE /openapi/2025-04/blog_collections/{id}

权限：write_content

Query Parameters

Name	Type	Description
id	String	博客专辑id

200: OK

{
    // Response
}