用接口批量入库文章时，分类、标签和定时发布分别由哪些字段决定？

通过接口把一批文章写进 AnQiCMS 时，字段对应关系可以按「归属、状态、时间」三组来记：归档导入接口（路径含 import 与 archive 两个词）接收一条记录，分类和标签字段决定它落在站点的哪个位置；草稿与待发布状态决定它是否对外可见；定时发布时间字段决定它到点什么时间自动上线。批量任务出错，多数是把三组字段的职责混在一起填。

一条导入记录里各字段管什么

接口文档里应当逐项写清下面这些约定。先看一张核对表：

分类与标签是两件事：分类管栏目结构，一个栏目下可以有很多标签；标签管横向聚合。批量导入前先确认目标分类在站内已建好，接口不会替你凭空创建栏目结构。

状态与定时发布分别走哪条链路

文档状态分为正式文档、草稿、待发布、回收站四档。接口写入时要理解两档的差异：草稿是未完成态，其链接带 preview 参数，只供预览核对，不进对外列表；待发布是「内容已定稿、等时间条件满足」的状态，定时发布字段就是给这一档用的。批量脚本里常见错误是把「还没审的稿子」直接按正式状态推接口，等于跳过了预览核对环节——稳妥做法是草稿先行，人工在后台过一遍，再转正式或挂定时发布。

按标题查重放在批量任务的哪一步

接口支持按标题查询文档是否已存在，这个动作要放在「组装记录」之后、「提交写入」之前：先把整批标题跑一遍存在性查询，把命中的条目单独列出来决定跳过还是更新，再提交剩余部分。不查就整批重推，同名文章就会出现两份，后补的清理成本比前置查重高得多。

公开接口文档该把哪些约定写清

给对接方看的 API 调用说明，至少要覆盖四件事：每个字段的必填与可空、状态字段的取值含义、时间字段的格式与时区口径、按标题查重的调用方式。高频能力（文档列表与详情、分类与标签、留言与评论等）在接口文档分类里都有对应说明，对接方照着文档填字段，而不是靠试错猜行为，是批量任务不出脏数据的另一半保障。

常见问题

问：定时发布和先存草稿再人工上线，选哪个？ 答：审校量小的例行内容用定时发布；对外口径敏感的内容先落草稿，预览确认后再定发布时间，两个机制不冲突。

问：导入的记录后来发现问题，能整体撤回吗？ 答：可以按状态处理：未发布的直接回草稿改；已发布的删除后进入回收站，仍可恢复，不必物理清空。

问：标签字段没填会怎样？ 答：文章正常入库，只是不入横向聚合页。批量任务里标签属于「可不填但建议填」字段，空缺多了站内搜索与推荐会变弱。