使用OAuth 2.0从Confluence下载附件遇问题求助

问题场景 #

通过OAuth2.0登录Confluence云，调用以下API获取页面附件信息：

https://api.atlassian.com/ex/confluence/{cloud_id}/wiki/rest/api/content/{content_id}/child/attachment

返回的_links中download字段为相对路径：

"_links": {
  "webui": "/pages/viewpageattachments.action?pageId=xxx&preview=zzz",
  "self": "https://aaa.atlassian.net/wiki/rest/api/content/ccc",
  "download": "/download/attachments/{attachments_id}/{file_name}?version=1&modificationDate=1744797121672&cacheVersion=1&api=v2"
}

直接拼接https://api.atlassian.com或实例域名前缀请求失败。

正确解决方法 #

1. 提取实例域名：从返回结果的self字段中获取你的Confluence云实例专属域名（示例中为https://aaa.atlassian.net）。
2. 拼接完整下载链接：将实例域名与download字段的相对路径直接拼接，示例完整链接为：

   https://aaa.atlassian.net/download/attachments/{attachments_id}/{file_name}?version=1&modificationDate=1744797121672&cacheVersion=1&api=v2
   

3. 携带授权头请求：发起下载请求时必须带上OAuth2.0的Bearer Token授权头：

   Authorization: Bearer {你的access_token}
   

关键说明 #

• api.atlassian.com是Atlassian统一API网关，仅适配带cloud_id的路径格式，附件下载接口需直接访问实例域名。
• 确保你的OAuth2.0 Token拥有read:confluence-content.all或对应附件的读取权限。

内容的提问来源于stack exchange，提问作者cargt5