接口批量导入内容时能带上哪些字段，哪些状态要靠后配

内容批量导入接口能带哪些字段，哪些状态要靠后配，这两问的答案都在顺序上：标题、关键词、描述、分类、标签、草稿位这些内容属性可以在导入时就写全；而发布时间、定时发布这类会影响状态流转的配置，建议等首批样本核验之后再逐条补上。顺序颠倒的常见后果是一整批内容带着错误的分类和半截的时间设置进入正式列表，回滚比补写更费时间。

导入接口覆盖的字段面

AnQiCMS 提供的文档内容导入接口路径是 /api/import/archive，它把站外整理好的内容按条目写入站内。一次请求里能落库的字段与后台编辑页的字段大致对得上，差别在于接口不会替你处理需要人工判断的项。

查重动作放在哪一步

批量导入最容易出的事故是重复入库。/api/import/archive 支持按标题查询是否已存在，正确的用法是在写入之前先查一次：把待导清单的标题逐条比对，命中已存在的条目要么跳过、要么改成更新动作，而不是再插一条。查重的时机也要固定——放在生成清单之后、发送请求之前，而不是导完再人工排查，后者在大清单上根本排不干净。

导入后文档处于什么状态

文档状态分为正式文档、草稿、待发布与回收站四类。批量导入的合理默认是草稿：落库后能在编辑页逐条看字段是否对齐，确认后转成正式文档对外可见。需要检查排版又不想公开时，草稿链接带上 preview 参数即可预览，不必先转正再藏起来。删除动作为什么是安全的，也在这套状态里——删除正式文档是移入回收站而非物理删除，误删可从回收站找回，但这不等于回收站能替代备份。

时间因子与定时发布为什么靠后

时间因子用于设定内容定时发布，它的前提是这篇内容本身已经确定无误。把定时发布放在导入参数里一起提交，等于在核验发生之前就排好了对外动作，一旦首批内容有问题，已经排期的条目会照发不误。稳妥的做法分两段：先导入并核验，再对通过的内容逐条设定发布时间，并把排期分批错开，避免出现一个瞬间集中放出大批内容的情况。

导入批次的核验清单

一次批次的收尾核验看五处：标题有没有被截断；关键词与描述是否落在位；分类与标签是否指到了预期条目；正文里的图片等静态资源是否随内容一起可用；随机抽几条以前台视角打开看排版。批量导入的入口不只有接口，站内也支持 ZIP 压缩包与 Excel 表格两种批量导入方式，三种入口的核验标准一致——都应以「抽正式文档、看前台表现」结束。

常见问题

问：导入接口能替代站内的批量导入吗？ 答：定位不同。接口适合由外部程序按条目推送并可先查再写；ZIP 压缩包与 Excel 表格更适合人工整理好的存量内容一次性迁入。

问：分类在导入清单里写名称还是编号？ 答：用站内已存在的分类标识。名称容易因空格或同义写法对不上，导致内容落到默认分类里，后期全站替换工具的改动量会明显上升。

问：导错了怎么批量收拾？ 答：先确认这批内容所处的状态。草稿阶段直接清理即可；已转正式的移入回收站，再按回收站逐条找回真正需要保留的，改动范围大时先做一次备份再继续操作。