Ghost Content API怎么用 博客内容获取接口教程

Ghost Content API是Ghost的内容获取接口，可以通过API获取文章和页面内容，适合做第三方前端展示和移动端App。它以只读方式提供已发布内容，常见用途包括搭建独立博客前端、制作内容列表或在应用中展示文章。下面从拿到密钥开始，按请求、筛选到页面渲染的顺序走一遍，照着替换示例中的域名和密钥，就能先把接口跑通。

第一步：获取Content API密钥

先登录Ghost后台，进入Settings，再打开Integrations，创建一个自定义集成并填写容易识别的名称，例如“前端博客”。创建完成后，页面会显示Content API Key和API URL。复制Content API Key备用，同时记下站点域名。注意选择Content API Key；不要把Admin API Key当成读取内容的密钥，也不要把它写进公开代码。

拿到站点域名后，先拼出文章列表接口。地址结构通常是站点域名加上 /ghost/api/content/posts/，请求参数里带上key和密钥。把下面的占位内容替换成自己的站点地址与密钥，再在浏览器打开测试：https://你的域名/ghost/api/content/posts/?key=你的密钥&limit=3。如果返回JSON且包含文章数组，基本就连通了。

第二步：查询文章和标签

读取文章使用posts端点，页面使用pages端点，标签使用tags端点；都属于GET请求。举例来说，文章列表可请求/ghost/api/content/posts/?key=密钥，标签列表则把posts换成tags。返回数据通常是JSON对象，文章数组在posts字段里，标签数组在tags字段里。想同时获取作者和标签信息，可添加include=authors,tags。

列表接口适合做首页卡片，详情页则按slug查询单篇文章，例如/posts/slug/文章别名/?key=密钥。取标题、摘要、封面图、发布时间等字段，就可以生成列表；详情内容如果需要HTML格式，可在请求中添加formats=html。文章内容不要直接当作可信代码执行，展示HTML时应做好内容净化，避免不安全标记影响页面。

使用过滤和分页参数

Ghost支持用filter筛选结果，例如按标签或精选状态过滤；参数写在问号后面，多个参数用&连接。比如filter=featured:true可以筛选精选文章，按标签筛选时可使用filter=tag:教程。标签名称如果含特殊字符，建议由URL编码函数处理参数，避免空格、中文或符号破坏请求地址。

分页用limit和page控制：limit设定每页返回条数，page设定页码。比如limit=10&page=2表示请求第二页，每页十条。响应通常带有pagination信息，可读取总页数或下一页状态，决定是否显示“加载更多”。若只需要少量字段，可以传fields=id,title,slug,excerpt，减小响应体积；列表不必拉取完整正文，点进详情再请求HTML会更省流量。

第三步：在前端展示内容

拿到JSON后，前端先检查请求状态，再读取posts数组并循环生成卡片。每张卡片可展示标题、摘要、主图和发布日期，点击后根据slug跳转详情页。浏览器端请求适合公开内容展示，但密钥仍应避免被误用；上线前确认站点跨域设置与请求方式正常。若跨域限制导致浏览器请求失败，可在自己的服务端做一层代理，再由前端请求代理接口。

开发时建议先用浏览器或接口调试工具确认URL、密钥和参数无误，再接入页面组件。遇到返回空列表，检查文章是否已发布、过滤条件是否写对；遇到认证错误，重新核对Content API Key和站点域名。还可以把请求封装成统一函数，集中处理错误、分页和空状态，让首页、标签页与详情页复用同一套逻辑。

如果你要先快速规划博客页面，也可以了解国内替代工具墨刀AI，用于梳理页面结构和原型流程；相关入口：modao.cgref.cn。在“润灭”的内容项目中，可先明确列表、详情与标签页的展示需求，再逐个对应Ghost接口字段，避免一开始就请求过多数据。