如何通过Confluence公开页面URL调用REST API获取对应page_id

1. 提取URL核心参数 #

你给出的示例URL属于Confluence标准美化格式，结构为：
https://<站点域名>/display/<空间Key>/<页面标题>
从示例URL https://confluence.som.yale.edu/display/SC/Finding+the+Page+ID+of+a+Confluence+Page 中可提取三个核心参数：

• 站点根地址：https://confluence.som.yale.edu
• 空间Key：SC
• 页面标题：Finding the Page ID of a Confluence Page（将URL中的+替换为空格即可）
  如果页面标题包含特殊字符，需要先做URL编码再传入后续请求参数

2. 调用REST API查询page_id #

直接调用Confluence原生的GET /rest/api/content接口，传入上面提取的参数即可返回页面基础信息，结果中的id字段就是你需要的page_id。

请求示例（curl命令） #

# 公开无权限限制的站点
curl "https://confluence.som.yale.edu/rest/api/content?spaceKey=SC&title=Finding%20the%20Page%20ID%20of%20a%20Confluence%20Page&type=page&limit=1"

# 私有需要身份校验的站点，替换为你自己的个人访问令牌即可
curl -H "Authorization: Bearer 你的个人访问令牌" "https://confluence.som.yale.edu/rest/api/content?spaceKey=SC&title=Finding%20the%20Page%20ID%20of%20a%20Confluence%20Page&type=page&limit=1"

返回结果参考 #

返回的JSON结构简化后如下，其中的id值就是目标页面的page_id：

{
  "results": [
    {
      "id": "123456789",
      "type": "page",
      "title": "Finding the Page ID of a Confluence Page",
      "space": {
        "key": "SC"
      }
    }
  ],
  "size": 1
}

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