Ghost Admin API 踩坑实录
用 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 现象: 创建成功后,API 响应里的 html 字段是 null,以为内容没存进去。 原因: 这是正常的。Ghost 内部把 HTML 转成了 Lexical JSON 存储,Admin API 响应不返回 HTML 内容。 验证方法: 用 Content API(公开的只读接口)来确认内容是否真的写进去了。 ...