集成网站：连接与配置
集成网站用于连接你的网站，让我的文档中的文章可以发送到网站后台。连接后，既能逐篇发布，也能通过导出管理分批执行，减少复制正文、图片和标签的操作。
能帮你做什么
- 连接已有网站：按网站类型填写地址和授权信息。
- 接入自建系统：通过自定义接口对接自己的 CMS。
- 配置发布目标：发送文章时选择网站及其支持的栏目、作者和状态。
- 控制标签同步：按网站设置是否携带文章标签。
集成网站负责连接；文章选择和排期在我的文档及导出管理中完成。它与知识库的官网导入用途不同：官网导入读取现有内容，集成网站向网站发送文章。
如何连接网站
1. 准备连接信息
确认网站类型、完整网址和授权信息。网址应包含 https:// 或 http://，并确认对应账号具有所需的文章操作权限。
| 网站类型 | 需要准备什么 |
|---|---|
| WordPress | 网站网址、登录用户名、应用程序密码 |
| ThinkCMF／易优 CMS | 网站网址、对接密钥，网站端需具备相应接收接口 |
| 自定义网站 | 账号名称、网站网址、密钥和四个 API 地址 |
WordPress 使用“应用程序密码”，可在后台用户个人资料中创建。使用对应账号的用户名和生成的应用程序密码填写连接。
自定义网站需由开发者先按网站对接API实现接口，再进行配置。
2. 添加账号
进入左侧“集成网站”，点击“添加账号”，选择网站类型，填写对应字段后点击“确定”。
自定义网站需要填写：
- 获取CMS配置API：提供栏目、作者等发布配置。
- 文章存在检查API：检查目标网站是否已有对应文章。
- 文章创建API：接收并创建文章。
- 文章更新API：更新已有文章。
“自定义 Token 参数名”可选。不填写时使用 Authorization: Bearer {Token}；填写时使用指定的请求头名称传递密钥，不带 Bearer 前缀。具体请求和返回格式见API 开发文档。
3. 设置标签同步
“导出是否携带标签”默认开启。关闭后，发送到该网站的文章不会同步文章标签。按网站实际需求设置，保存后检查账号是否出现在列表中。
验证连接
保存后，打开一篇已核对文章，在发布面板选择该网站，检查能否读取栏目、作者等发布配置。保存账号只代表配置已建立，不代表文章已发送。
再按导出到网站发送一篇草稿或测试文章，核对实际结果。通过后再配置批量与定时导出。
连接与接口问题
| 问题 | 优先检查 |
|---|---|
| 无法添加账号 | 网站类型、完整网址及授权字段是否填写正确，是否已添加相同连接 |
| 无法读取发布配置 | 网站接口是否可访问，密钥及权限是否有效；自定义接口返回格式是否符合文档 |
| 更新文章失败 | 检查文章存在检查、更新接口，以及目标文章是否仍存在 |
修改网站地址或轮换密钥后，在账号列表编辑连接信息，并重新验证一篇文章。删除连接前，检查是否有导出配置仍在使用该网站。