Ghost Admin API 踩坑实录

Fri, 15 May 2026 00:00:00 +0000

用 Ghost 6.x Admin API 发布内容时踩的几个坑，记录下来省得下次再踩。

坑一：HTML 内容神秘消失

现象： 用 POST /ghost/api/admin/posts/ 创建文章，传了 html 字段，返回成功，但文章正文是空的。

原因： Ghost 6.x 默认期望的内容格式是 Lexical（一种 JSON 结构），不是 HTML。如果你直接传 html 字段但不告诉 Ghost 这是 HTML，它会静默忽略。

解决： 在 URL 后面加 ?source=html：

# 错误——html 被忽略
POST /ghost/api/admin/posts/
# 正确——Ghost 自动把 HTML 转成 Lexical
POST /ghost/api/admin/posts/?source=html

现象： 创建成功后，API 响应里的 html 字段是 null，以为内容没存进去。

原因： 这是正常的。Ghost 内部把 HTML 转成了 Lexical JSON 存储，Admin API 响应不返回 HTML 内容。

验证方法： 用 Content API（公开的只读接口）来确认内容是否真的写进去了。