Confluence

集成 Confluence API,支持托管 OAuth。管理页面、空间、博客文章、评论及附件。当用户需要创建、读取、更新或删除 Confluence 内容,管理空间,或处理评论和附件时使用此技能。其他第三方应用请使用 api-gateway 技能。需网络访问权限及有效的 Maton API 密钥。

安装

概览

Confluence 是一个专为 Atlassian Confluence Cloud 设计的 API 集成工具,通过托管 OAuth 认证机制,为开发者提供了安全、便捷地与 Confluence 云端知识库进行交互的通道。该工具封装了 Confluence 的核心内容管理能力,支持对页面、空间、博客文章、评论及附件等资源的创建、读取、更新和删除操作。与直接使用原生 REST API 不同,Confluence 技能通过统一的网关接口简化了身份验证流程,用户只需配置有效的 Maton API 密钥即可开始使用。所有请求均通过标准化的 Authorization 头部进行认证,并自动处理云实例识别与连接管理,极大降低了第三方应用接入 Confluence 的技术门槛。目前推荐使用 V2 版本的 API 路径,以获得更丰富的功能和更好的稳定性。

核心功能特点

  1. 支持完整的 Confluence 内容管理:包括页面、空间、博客文章的增删改查
  2. 内置 OAuth 认证管理:通过 Maton 平台自动处理授权流程与连接维护
  3. 兼容 V1 和 V2 API:优先推荐使用功能更强大的 V2 版本接口
  4. 支持多种内容格式:提供 storage(存储格式)、atlas_doc_format 和 view(渲染 HTML)三种内容表示方式
  5. 细粒度权限控制:可通过 Maton-Connection 标头指定特定连接,实现多实例环境下的精准操作
  6. 完善的错误处理机制:返回标准 HTTP 状态码,便于排查权限、资源不存在或数据冲突等问题

适用场景

Confluence 技能特别适合需要自动化处理企业知识库内容的场景。例如,在团队协作中,开发人员可以通过该工具批量创建技术文档页面,或将外部系统生成的报告自动发布到指定空间;市场部门则可利用其管理产品发布说明或客户 FAQ 博客,实现内容的全生命周期管理。对于系统集成商而言,当需要将 Confluence 作为知识中枢与其他办公工具(如 Jira、Slack)联动时,该技能提供了稳定可靠的 API 桥梁,确保信息在不同平台间无缝流转。此外,运维团队也可借助此接口定期备份关键页面内容,或在系统升级前快速归档历史资料。无论是构建内部文档机器人、开发自定义仪表板,还是实现 CI/CD 流程中的文档同步,Confluence 都能满足高效、安全的远程操作需求。