Confluence REST API如何上传XML并创建页面-XML/RSS教程-PHP中文网

Confluence REST API 不支持直接上传 XML 创建页面，需先解析 XML 提取 title 和 body.storage.value，再以 JSON 格式调用 POST /rest/api/content；宏、附件、子页面需单独处理。

confluence rest api如何上传xml并创建页面

Confluence REST API 不支持直接上传 XML 创建页面

Confluence 的官方 REST API 没有提供「上传任意 XML 文件并自动解析为页面」的端点。所谓“XML 页面导出格式”（如通过 /exportpage.action 生成的 XHTML-like XML）是 Confluence 内部导出/导入机制使用的私有格式，不能直接 POST 给 REST API。试图用 POST /rest/api/content 提交这种 XML 会触发 400 或 500 错误，常见报错如："Invalid value for body: expected map, got string" 或 "Unrecognized field 'version'"（因 XML 结构与 JSON Schema 完全不匹配）。

正确做法：解析 XML 内容，提取 title + body，再调用标准创建接口

如果你手头有一个 Confluence 导出的 .xml 文件（例如从旧空间导出的单页 XML），需先人工或脚本解析它，从中提取两个关键字段：title 和 body.view.value（即 XHTML 格式的正文内容）。然后按标准 JSON 格式构造请求体。

Confluence 导出 XML 中的页面标题通常在 My Page 或 My Page 节点下
正文内容一般包裹在 ... 或类似结构中，注意剔除宏标签（它们在 REST API 中不被识别，需转成等效 HTML 或移除）
必须将提取出的 XHTML 片段包裹进标准的 body.storage.value 字段，并声明 body.storage.representation = "storage"
认证必须使用有效 API Token（Basic Auth 或 Bearer Token），且用户需有目标空间的编辑权限

curl -X POST \
  'https://your-domain.atlassian.net/wiki/rest/api/content' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "page",
    "title": "My Imported Page",
    "space": {
      "key": "DEVS"
    },
    "body": {
      "storage": {
        "value": "<p>This is <em>imported</em> content.</p>",
        "representation": "storage"
      }
    },
    "ancestors": [
      {
        "id": 123456789
      }
    ]
  }'

注意宏（macro）、附件、子页面无法通过 XML 解析自动还原

Confluence 导出 XML 中的、等节点，在 REST API 创建页面时不会被识别或处理。这些元素必须手动转换：

Wordpress REST API

OpenClaw技能，提供WordPress REST API命令行工具，支持通过原生HTTP处理文章、页面、分类、标签、用户及自定义请求。

下载

需替换为对应 HTML（如 toc 宏 → 本身不可用，只能删掉或改用手动目录）
附件需单独调用 POST /rest/api/content/{id}/child/attachment 接口上传，且必须在页面创建成功后获取其 id 才能关联
子页面关系（）不会被自动创建；需递归解析 XML 树，按父子顺序依次创建页面，并在每页的 ancestors 中填入上层页面 ID
导出 XML 中的时间戳、作者信息（）在 REST API 创建时会被忽略，实际创建人始终是 API 调用者