用途:为 Jira、Confluence 等 Atlassian 平台提供 REST API 集成能力,用于自动化、脚本编写和跨平台同步,适合在处理 Jira/Confluence 接口、Webhook 与平台集成时启用。
认证:Cloud 环境使用 API Token,配合 HTTPBasicAuth 传入邮箱与 API_TOKEN,并设置 Accept 与 Content-Type 为 application/json,base_url 形如 https://your-domain.atlassian.net。也可使用 Python 客户端库 from atlassian import Jira, Confluence,传入 url、username、password 并设 cloud=True。
Jira 能力:创建、获取、更新 issue,执行工作流状态转换(需先查询可用 transitions 的 ID),添加评论,使用 JQL 搜索并指定返回字段。敏捷接口支持获取 board、board 下的 sprint、sprint 内 issue,以及将 issue 移入 sprint。
Confluence 能力:创建、获取、更新页面,更新时需在 version.number 上递增;使用 cql 搜索内容,例如 space = GA AND text ~ "agent"。
Webhook:可注册 webhook(如 jira:issue_created、jira:issue_updated、sprint_started、sprint_closed),并可用 Flask 接收处理,按 webhookEvent 分发;更新事件可读取 changelog 中状态字段变化。
自动化示例:从分支名提取 Jira 键将 GitHub PR 同步到 Jira;按 fixVersion 查询 issue 并按类型分组生成发布说明,再创建 Confluence 页面。资料还给出若干命令形式,如 /atlassian-sync、/jira-create、/confluence-publish。
限制:资料未说明具体计费、价格、平台支持范围、速率限制或权限要求;示例 URL、项目键、空间键、ID 等均为占位值,需按实际环境替换,不能直接照搬。