API 优先 / 无头

把 ContentPulse 文章拉取到你的 Laravel 应用中。

运行自己的前端?ContentPulse 是 API 优先的。用一个 API 密钥连接你的 Laravel 应用,监听一个 webhook,并在你自己的 Blade 视图中渲染现成的文章 HTML — 你的路由,你的设计,你的域名。

官方包:composer require contentpulseio/laravel — 或在任意框架中使用纯 REST API。

四步完成设置

第 1 步

创建一个 API 密钥

在 ContentPulse 中,进入设置 › API 密钥,为你的站点创建一个密钥。将它存放在你的 Laravel .env 中。

第 2 步

注册一个 webhook

在 ContentPulse 中添加一个指向你应用的 webhook(例如 /webhooks/contentpulse),并订阅 content.published。我们会对每次投递进行签名,方便你验证来源确实是我们。

第 3 步

获取文章

当 webhook 触发时,用你的密钥(X-API-Key 请求头)调用我们的 REST API 获取文章:标题、slug、SEO meta、图片 URL、FAQ 问答对以及预渲染的 HTML。

第 4 步

在你的 Blade 视图中渲染

存储载荷并在你的视图中输出 {!! $article->rendered_html !!}。该 HTML 自包含且与主题无关 — 它会继承你的排版和样式。

API 为你提供的内容

预渲染的文章 HTML

每篇文章都附带 rendered_html — 干净、语义化、不含框架类名的标记 — 你只需存储并输出。你这边无需任何区块解析或拼装逻辑。

完整的 SEO 载荷

meta 标题、meta 描述、slug、关键词和主图 URL 在同一个响应中返回,可直接放入你布局的 <head>

用于 JSON-LD 的 FAQ 数据

问答对会被提取到结构化的 faq 数组中,方便你输出 FAQPage JSON-LD 并争取富媒体搜索结果。

带签名的 webhook

content.publishedcontent.updated 等事件上获得通知。每次投递都经过 HMAC 签名,你的端点可以验证其真实性。

天生支持内容刷新

当 ContentPulse 刷新一篇文章时,你会收到带有相同标识符的更新 webhook — 就地更新你存储的副本,URL 永不改变。

你的链接,你的域名

设置你的资源中心 URL,文章内部的链接在到达 API 之前会被重写为你自己的域名 — 不会有 ContentPulse 的 URL 泄漏到你的站点。

常见问题

不 &mdash; 这是一个返回 JSON 响应并提供 webhook 的纯 REST API,任何技术栈都适用:Symfony、Rails、Django、Next.js 或静态站点生成器。Laravel 只是我们大多数无头客户所使用的框架。
不必。API 为文章正文返回预渲染、自包含的 HTML。你只需用自己的布局和排版包裹它;标题、列表、图片、FAQ 和提示框都已结构化。
订阅内容 webhook。在 content.published 或 content.updated 时,按 ID 获取文章并更新(upsert)你的本地副本。slug 和 ID 在刷新之间保持稳定。
有,但对这个用例来说非常宽裕:标准读取为每个密钥每分钟 60 次请求。典型的发布同步每篇文章只用一个 webhook 和一次获取。

你的前端,我们的编辑工作流。一个下午就能接好。

Cookie Notice

We use cookies to enhance your experience, remember your preferences, and analyze site traffic. Read our Cookie Policy for details.