内容导入接口
📅 2026-11-21
👁️ 0
内容导入接口
内容导入接口用于让第三方平台(如 AI 写作工具、火车头采集器)通过 HTTP API 把内容写入本站。
入口路径
后台顶部菜单 →「功能」→「内容生产」→「内容导入接口」。实际地址:/system/plugin/contentops/importapi,需要管理员权限(canAdmin)。
功能说明
页面展示本站 Token、文档导入接口、获取分类接口和火车头发布模块的配置说明及 POST 表单字段。
界面截图

设置项说明
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 我的 Token | 接口鉴权凭证 | 自动生成,可点「更新Token」重置 [源码] | 不要在公开文档或截图中暴露真实值 | 泄露等同于写入权限泄露 |
| 文档导入接口 | POST /api/import/archive?token=<你的Token> |
请求类型 form-data [源码] |
按页面字段说明提交 | title/content/category_id 必填 |
| 获取分类接口 | 供第三方读取本站分类 | 接口地址见页面 | 先取分类 ID 再导入文档 | — |
常用 POST 字段:title(必填,标题)、content(必填,内容)、category_id(必填,分类 ID)、keywords、description、url_token、logo、images[]、publish_time、tag、draft、cover。
操作步骤
- 进入页面查看 Token 与接口地址。
- 在第三方平台填写接口地址、请求方式和 Token。
- 按字段说明提交内容。
- 返回 JSON 中
code=200表示成功;到文档列表确认内容已写入。
适用场景与建议
- 适合把外部系统生成的内容批量导入本站。
publish_time可设置为未来时间,实现定时发布;draft=true时进入草稿箱。
注意事项
- Token 是敏感凭证,不要在公开文档、截图或聊天中传播真实值。
cover参数控制同名内容是否覆盖:1覆盖、0报错、2跳过判断。- 接口返回的 URL 依赖「全局设置 → 网站地址」,地址配置错误会导致返回错误链接。