You need to enable JavaScript to run this app. Confluence本地部署版通过REST接口创建/更新页面的内容格式要求是什么?
优惠活动
大模型
产品
解决方案
定价
更多

Confluence本地部署版通过REST接口创建/更新页面的内容格式要求是什么?

本地部署Confluence 6.6.0 内容接口格式说明

核心判断

使用REST接口创建、更新本地部署Confluence页面时,传入的页面正文既不是纯HTML格式,也不能直接传原生Confluence Wiki标记,需要使用Confluence专属的存储格式(Storage Format)。

常见踩坑点

  • 不要直接把浏览器里渲染出的页面HTML片段抠下来当内容传:这类HTML带一堆前端冗余样式、无意义的嵌套标签,过不了Confluence的标签校验,最后传上去的内容会格式全乱
  • 不要直接把轻量Wiki标记语法(比如*加粗文字*、[跳转链接|目标页面]这类你平时在编辑器里敲的简写语法)当正文传:这类语法是给前端编辑器做解析用的,接口层不会直接把它当可入库的存储内容处理

实操注意事项

  • Confluence存储格式是基于XHTML扩展的专属标记规范,内置了Confluence自定义标签,用来标识宏、附件引用、页面锚点、嵌入多媒体这类特有元素,只有符合这个规范的内容才能被正确存储和渲染
  • 如果你手头只有现成的Wiki标记内容,不用手动逐字符转格式,直接调用Confluence内置的格式转换接口把Wiki标记转成合规的存储格式字符串,再塞到创建/更新请求的body里就行
  • 想快速拿到合规格式内容的话,直接从现有正常页面的接口返回值里,提取body.storage节点的内容复用就可以,这块返回的内容本身就是标准存储格式,不需要二次调整
  • 构造请求体的时候,一定要在body的storage结构里把representation参数设为storage,明确告诉接口当前传入的正文格式类型,避免默认解析逻辑把内容识别错

格式传错的典型表现

没按要求传合规格式的内容时,接口一般不会直接抛致命报错,但最终渲染的页面会出现样式丢失、宏不生效、附件链接失效、列表层级错乱的问题。

内容的提问来源于stack exchange,提问作者JF Meier

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 11:06:08