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
相关产品推荐
相关产品推荐

