Ghost Admin API怎么用 博客内容管理接口教程

Ghost Admin API是Ghost博客的管理接口，可以通过API创建、编辑和发布文章，适合做自动化内容发布和同步。它与只读的Content API不同，能在授权范围内管理站点内容。下面用“创建集成、写入文章、发布同步”的顺序说明基本流程；示例以官方JavaScript客户端为主，实际使用时请将站点地址、密钥和文章内容替换为自己的值。

第一步：获取API密钥

先登录Ghost后台，进入Settings（设置）里的Integrations（集成），选择Add custom integration（添加自定义集成），填入容易识别的名称，例如“文章同步脚本”。创建后页面会显示Admin API URL和密钥。把这两项复制到密码管理器或服务器环境变量中，不要直接写进公开代码仓库，也不要把密钥发给不可信的人。

接着确认接口地址和站点版本。Admin API URL通常来自刚才创建的集成页面，不要自行拼错域名或路径。使用SDK时，按该SDK要求填写Ghost站点URL、密钥和API版本；版本值应与当前服务端兼容。若直接发HTTP请求，Admin API需要用密钥签署短时JWT，再放入Authorization请求头，不能把原始密钥当成Bearer令牌发送。

如果用Node.js操作，可以安装Ghost官方Admin API客户端，并从环境变量读取凭据。比如在终端设置GHOST_URL与GHOST_ADMIN_API_KEY，然后在程序中初始化客户端。不同版本SDK的参数写法可能略有不同，安装后先对照所用版本的说明。建议先在测试站点调用一次读取接口，确认认证成功，再开始新增或修改内容。

第二步：创建和编辑文章

新建文章时，准备标题、正文和状态等字段。常见做法是调用posts.add，传入title与HTML正文，并指定source为html；若希望先检查内容，可将status设为draft，创建后让编辑人员在后台预览。正文也可以使用Ghost编辑器支持的内容格式，关键是请求中的格式声明与实际正文保持一致。

编辑已有文章时，先通过列表或读取接口找到文章的id，再调用posts.edit提交需要更新的字段。更新时通常还要带上文章当前的updated_at值，避免覆盖其他人在后台刚做的修改。只传需要更改的字段会更清楚；若接口返回校验错误，检查字段名称、正文格式、必需属性，以及文章是否仍存在。

建议把创建和更新封装成两个独立函数，并记录每次请求的文章ID、状态和错误信息。发生网络超时不要立刻盲目重试创建，否则可能生成重复文章；可以先按标题、slug或外部内容ID查询是否已存在，再决定继续创建还是更新。对批量同步任务，也应限制并发并做好失败重试。

管理标签和作者

创建文章时可在tags字段中传入标签名称或对象，作者则通过authors字段关联已有作者。标签用于分类和筛选，建议提前统一命名，避免“教程”“教程类”等近似标签越积越多。作者必须是Ghost站点中可用的用户；若提交作者后接口报错，先检查关联对象是否存在，以及当前集成是否有相应操作权限。

批量导入时，可以先获取站点已有标签和作者，再根据名称或slug匹配对应记录。若确实需要新标签，按Tags API支持的方式创建后再关联文章。同步脚本最好保留外部系统的内容编号与Ghost文章ID映射，这样后续更新时能准确找到原文，也不会因标题修改而误建重复内容。

第三步：发布和同步内容

内容审核通过后，可在创建文章时设置published状态，或对已有草稿调用编辑接口更新状态。立即发布前先核对标题、正文、标签、作者和链接；需要定时发布时，设置scheduled状态及合适的published_at时间。时间应带明确时区，避免服务器时区与编辑人员所在地不同而导致发布时间偏移。

要同步外部内容，建议按固定流程执行：读取来源数据、判断新增或更新、写入Ghost、检查接口响应，最后保存同步时间和文章ID。遇到限流或临时错误时采用逐步延迟重试；遇到权限、字段验证等确定性错误，则记录详情并停止该条任务，避免重复请求。可以先用一篇测试文章验证发布结果，再启用定时任务。

如果团队希望用国内工具辅助搭建内容管理或自动化流程，可了解墨刀AI等方案；它不能替代Ghost Admin API的认证和接口调用，接入时仍需按Ghost文档配置密钥与权限。也可访问modao.cgref.cn了解相关信息。若由“润灭”团队维护同步服务，同样建议将凭据放在服务端配置中，并为测试、生产环境分别管理。

最后，先从草稿与少量文章开始测试，再逐步接入正式发布和定时同步。定期检查API版本、运行日志及失败队列；当密钥可能泄露或人员离职时，及时在后台撤销并重新创建集成密钥。这样既能减少误发布，也能让后续排查更容易。