内容导入接口

📅 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。

操作步骤

  1. 进入页面查看 Token 与接口地址。
  2. 在第三方平台填写接口地址、请求方式和 Token。
  3. 按字段说明提交内容。
  4. 返回 JSON 中 code=200 表示成功;到文档列表确认内容已写入。

适用场景与建议

  • 适合把外部系统生成的内容批量导入本站。
  • publish_time 可设置为未来时间,实现定时发布;draft=true 时进入草稿箱。

注意事项

  • Token 是敏感凭证,不要在公开文档、截图或聊天中传播真实值。
  • cover 参数控制同名内容是否覆盖:1 覆盖、0 报错、2 跳过判断。
  • 接口返回的 URL 依赖「全局设置 → 网站地址」,地址配置错误会导致返回错误链接。

相关文档