把 ContentPulse 文章拉取到你的 Laravel 应用中。
运行自己的前端?ContentPulse 是 API 优先的。用一个 API 密钥连接你的 Laravel 应用,监听一个 webhook,并在你自己的 Blade 视图中渲染现成的文章 HTML — 你的路由,你的设计,你的域名。
官方包:composer require contentpulseio/laravel — 或在任意框架中使用纯 REST API。
四步完成设置
注册一个 webhook
在 ContentPulse 中添加一个指向你应用的 webhook(例如 /webhooks/contentpulse),并订阅 content.published。我们会对每次投递进行签名,方便你验证来源确实是我们。
获取文章
当 webhook 触发时,用你的密钥(X-API-Key 请求头)调用我们的 REST API 获取文章:标题、slug、SEO meta、图片 URL、FAQ 问答对以及预渲染的 HTML。
在你的 Blade 视图中渲染
存储载荷并在你的视图中输出 {!! $article->rendered_html !!}。该 HTML 自包含且与主题无关 — 它会继承你的排版和样式。
API 为你提供的内容
预渲染的文章 HTML
每篇文章都附带 rendered_html — 干净、语义化、不含框架类名的标记 — 你只需存储并输出。你这边无需任何区块解析或拼装逻辑。
完整的 SEO 载荷
meta 标题、meta 描述、slug、关键词和主图 URL 在同一个响应中返回,可直接放入你布局的 <head>。
用于 JSON-LD 的 FAQ 数据
问答对会被提取到结构化的 faq 数组中,方便你输出 FAQPage JSON-LD 并争取富媒体搜索结果。
带签名的 webhook
在 content.published、content.updated 等事件上获得通知。每次投递都经过 HMAC 签名,你的端点可以验证其真实性。
天生支持内容刷新
当 ContentPulse 刷新一篇文章时,你会收到带有相同标识符的更新 webhook — 就地更新你存储的副本,URL 永不改变。
你的链接,你的域名
设置你的资源中心 URL,文章内部的链接在到达 API 之前会被重写为你自己的域名 — 不会有 ContentPulse 的 URL 泄漏到你的站点。