用途:指导在 Kuroco HeadlessCMS 中进行内容管理,包括创建、获取、更新、删除及结构与字段定义的理解,并说明前端 API 与管理 API 的用法差异。
主要能力:内容采用「内容定义(TopicsGroup)→ 分类(TopicsCategory)→ 内容(Topics)」的层级结构;内容定义可设置正文输入方式(WYSIWYG、Markdown、HTML)与浏览/编辑限制,并可配置最多 99 个扩展项目(ext_col_01 至 ext_col_XX),类型含文本、文本域、WYSIWYG、数值、日期、单选、多选、文件/图片、链接、关联内容。Topics API 提供 list、details、insert、update、delete、bulk_upsert 操作。过滤查询使用 filter={field} {operator} {value},支持 =、!=、>、>=、<、<=、contains、in、not_in 及 and/or 复合条件,排序用 order_by。文件上传后需将 file_id 关联到内容。
使用方式:前端 API 路径形如 /rcms-api/{api_id}/{path},如 /rcms-api/1/news/insert,使用 fetch 并携带 Cookie 认证。管理 API 路径形如 /direct/rcms_api/mng_api/,如 ?mt=topics&ct=topics_group_list&columns=topics_group_id,group_nm 获取内容定义列表,?mt=topics&ct=topics_list&topics_group_id[]=1&cnt=10&columns=topics_id,subject,ymd 获取内容列表,topics_edit 用于创建。建议在端点设置中启用缓存(如 86400 秒),更新时自动清除;分页用 pageID 与 cnt。
适用场景:站点结构把握、数据批量确认与修改、模式(schema)确认、前端内容 API 实现与运维操作。
限制:管理 API 的 insert/update/delete 需在执行前获得用户确认;前端 API 面向终端用户,管理 API 面向管理员;扩展项目、批量更新、分类、标签、浏览限制等细节需另见对应参考文件。相关技能包括 /kuroco-api-integration、/kuroco-mng-api-browser、/kuroco-smarty-plugins、/kuroco-webhook-processing;文档参见 docs/tutorials/adding-a-topics.md、docs/tutorials/bulk-upload-in-csv.md、docs/management/content-structure-topics.md、docs/reference/filter-query.md。