内容条目操作

article.*、product.*、case.*、product_category.* 共 15 个操作。

本页由 docs:sync 从 OperationRegistry 生成,请勿手工编辑。

article.create

新建文章/新闻(一律草稿落库不上线,供先写后审)。content 为正文(Markdown),可由你根据客户要求撰写。客户要求发布时随后调用 article.publish(需客户确认)。

项 值
风险分级 R1(修改内容)
所需权限 content.edit
需要确认 否
触发重建 是
独立部署可用 是

业务参数 params

字段 类型 必填 说明
title string 是
summary string 否
channel integer 否 所属栏目 ID(可选;不传=该模型的内置栏目。自建栏目 id 用 query.channels 查)
content string 否 正文(Markdown)
cover_image string 否 封面图 URL
status string:draft 否 仅支持 draft(转回草稿下线);发布请用 article.publish 操作(需客户确认)
scheduled_at string 否 定时发布时间(ISO 8601,如 2026-07-10T09:00:00+08:00):配合草稿使用,到点自动发布上线;客户说"明早发布这篇"时设置

article.delete

删除文章。需要客户确认后才会执行。

项 值
风险分级 R2(删除)
所需权限 content.edit
需要确认 是
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
id integer 是 目标 ID(先用查询工具获取)

article.publish

发布文章(草稿→已发布,正式对外)。高危:需在界面确认,确认后正式发布上线。

项 值
风险分级 R3(发布上线)
所需权限 content.edit
需要确认 是
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
id integer 是 目标 ID(先用查询工具获取)

article.update

修改文章字段(只传需要修改的字段)。目标文章已发布时,修改需客户在界面确认后生效并正式发布。

项 值
风险分级 R1(修改内容)
所需权限 content.edit
需要确认 否
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
id integer 是 目标 ID(先用查询工具获取)

业务参数 params

字段 类型 必填 说明
title string 否
summary string 否
channel integer 否 所属栏目 ID(可选;不传=该模型的内置栏目。自建栏目 id 用 query.channels 查)
content string 否 正文(Markdown)
cover_image string 否 封面图 URL
status string:draft 否 仅支持 draft(转回草稿下线);发布请用 article.publish 操作(需客户确认)
scheduled_at string 否 定时发布时间(ISO 8601,如 2026-07-10T09:00:00+08:00):配合草稿使用,到点自动发布上线;客户说"明早发布这篇"时设置

case.activate

上线案例(未上线→已上线,正式对外)。高危:需在界面确认,确认后正式发布上线。

项 值
风险分级 R3(发布上线)
所需权限 content.edit
需要确认 是
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
id integer 是 目标 ID(先用查询工具获取)

case.create

新增工程案例(一律下架状态落库、不对外,供先建后审)。客户要求上线时随后调用 case.activate(需客户确认)。

项 值
风险分级 R1(修改内容)
所需权限 content.edit
需要确认 否
触发重建 是
独立部署可用 是

业务参数 params

字段 类型 必填 说明
title string 是
summary string 否
channel integer 否 所属栏目 ID(可选;不传=该模型的内置栏目。自建栏目 id 用 query.channels 查)
content string 否 案例正文(Markdown)
images array 否
seo object 否 页面级 SEO(覆盖式,整体替换)
sort integer 否

case.delete

删除工程案例。需要客户确认后才会执行。

项 值
风险分级 R2(删除)
所需权限 content.edit
需要确认 是
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
id integer 是 目标 ID(先用查询工具获取)

case.update

修改案例字段(只传需要修改的字段)。目标案例已上线时,修改需客户在界面确认后生效并正式发布。

项 值
风险分级 R1(修改内容)
所需权限 content.edit
需要确认 否
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
id integer 是 目标 ID(先用查询工具获取)

业务参数 params

字段 类型 必填 说明
title string 否
summary string 否
channel integer 否 所属栏目 ID(可选;不传=该模型的内置栏目。自建栏目 id 用 query.channels 查)
content string 否 案例正文(Markdown)
images array 否
seo object 否 页面级 SEO(覆盖式,整体替换)
sort integer 否

product.activate

上架产品(下架→上架,正式对外)。高危:需在界面确认,确认后正式发布上线。

项 值
风险分级 R3(发布上线)
所需权限 content.edit
需要确认 是
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
id integer 是 目标 ID(先用查询工具获取)

product.create

新增产品(一律下架状态落库、不对外,供先建后审)。建议先查询分类,把产品归入合适的分类。客户要求上架时随后调用 product.activate(需客户确认)。

项 值
风险分级 R1(修改内容)
所需权限 content.edit
需要确认 否
触发重建 是
独立部署可用 是

业务参数 params

字段 类型 必填 说明
name string 是
category_id integer 否 所属分类 ID
channel integer 否 所属栏目 ID(可选;不传=该模型的内置栏目。自建栏目 id 用 query.channels 查)
summary string 否 一句话简介,列表页展示
description string 否 产品详情正文(Markdown)
images array 否 图片 URL 数组
specs array 否 规格参数表
seo object 否 页面级 SEO(覆盖式,整体替换)
sort integer 否
status string:hidden 否 仅支持 hidden(下架,不出现在站点,数据保留);上架请用 product.activate 操作(需客户确认)

product.delete

删除产品。需要客户确认后才会执行。

项 值
风险分级 R2(删除)
所需权限 content.edit
需要确认 是
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
id integer 是 目标 ID(先用查询工具获取)

product.update

修改产品字段(只传需要修改的字段)。目标产品已上架时,修改需客户在界面确认后生效并正式发布。

项 值
风险分级 R1(修改内容)
所需权限 content.edit
需要确认 否
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
id integer 是 目标 ID(先用查询工具获取)

业务参数 params

字段 类型 必填 说明
name string 否
category_id integer 否 所属分类 ID
channel integer 否 所属栏目 ID(可选;不传=该模型的内置栏目。自建栏目 id 用 query.channels 查)
summary string 否 一句话简介,列表页展示
description string 否 产品详情正文(Markdown)
images array 否 图片 URL 数组
specs array 否 规格参数表
seo object 否 页面级 SEO(覆盖式,整体替换)
sort integer 否
status string:hidden 否 仅支持 hidden(下架,不出现在站点,数据保留);上架请用 product.activate 操作(需客户确认)

product_category.create

新增产品分类。

项 值
风险分级 R1(修改内容)
所需权限 content.edit
需要确认 否
触发重建 是
独立部署可用 是

业务参数 params

字段 类型 必填 说明
name string 是
seo object 否 页面级 SEO(覆盖式,整体替换)
sort integer 否

product_category.delete

删除产品分类(分类下有产品时会被拒绝)。需要客户确认。

项 值
风险分级 R2(删除)
所需权限 content.edit
需要确认 是
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
id integer 是 目标 ID(先用查询工具获取)

product_category.update

修改产品分类名称或排序。

项 值
风险分级 R1(修改内容)
所需权限 content.edit
需要确认 否
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
id integer 是 目标 ID(先用查询工具获取)

业务参数 params

字段 类型 必填 说明
name string 否
seo object 否 页面级 SEO(覆盖式,整体替换)
sort integer 否