API-first / headless

Đưa bài viết ContentPulse vào ứng dụng Laravel của bạn.

Bạn sở hữu frontend của mình? ContentPulse được xây dựng theo hướng API-first. Kết nối ứng dụng Laravel của bạn bằng API key, lắng nghe webhook và hiển thị HTML bài viết hoàn chỉnh trong các Blade view của riêng bạn — route của bạn, thiết kế của bạn, tên miền của bạn.

Bắt đầu miễn phí Xem trên GitHub Xem bảng giá

Gói chính thức: composer require contentpulseio/laravel — hoặc dùng REST API thuần từ bất kỳ framework nào.

Thiết lập trong bốn bước

BƯỚC 1

Tạo API key

Trong ContentPulse, vào Cài đặt › API Keys và tạo khóa cho website của bạn. Lưu trong tệp .env của ứng dụng Laravel.

BƯỚC 2

Đăng ký webhook

Thêm webhook trong ContentPulse trỏ đến ứng dụng của bạn (ví dụ /webhooks/contentpulse), đăng ký sự kiện content.published. Chúng tôi ký mọi lần gửi để bạn xác minh đó là chúng tôi.

BƯỚC 3

Lấy bài viết

Khi webhook kích hoạt, gọi REST API của chúng tôi với khóa của bạn (header X-API-Key) để lấy bài viết: tiêu đề, slug, meta SEO, URL hình ảnh, các cặp FAQ và HTML đã render sẵn.

BƯỚC 4

Hiển thị trong Blade view của bạn

Lưu những gì bạn cần và hiển thị {!! $article->rendered_html !!} trong template của bạn. HTML độc lập và trung lập với theme — kế thừa typography và style của bạn.

API mang lại gì cho bạn

HTML bài viết render sẵn

Mỗi bài viết đi kèm rendered_html — markup ngữ nghĩa sạch không có class framework — lưu và hiển thị. Không cần phân tích section hay viết logic template ở phía bạn.

Gói SEO đầy đủ

Tiêu đề meta, mô tả meta, slug, từ khóa và URL ảnh đại diện đến trong cùng một phản hồi, sẵn sàng cho <head> của layout.

Dữ liệu FAQ cho JSON-LD

Các cặp hỏi/đáp được trích xuất thành mảng faq có cấu trúc để bạn hiển thị FAQPage JSON-LD và cạnh tranh rich results.

Webhook được ký

Nhận thông báo về content.published, content.updated và hơn thế. Mọi lần gửi đều được ký HMAC để endpoint của bạn xác minh tính xác thực.

Hỗ trợ làm mới mặc định

Khi ContentPulse làm mới một bài viết, bạn nhận webhook cập nhật với cùng định danh — cập nhật bản sao đã lưu tại chỗ, và URL không bao giờ thay đổi.

Liên kết của bạn, tên miền của bạn

Cho chúng tôi biết URL trung tâm tài nguyên của bạn và các liên kết nội bộ trong bài viết sẽ được viết lại trỏ đến tên miền của bạn trước khi đến API — không có URL ContentPulse nào lọt vào trang của bạn.

Câu hỏi thường gặp

Không — đây là REST API thuần với phản hồi JSON và webhook, nên mọi stack đều dùng được: Symfony, Rails, Django, Next.js hay trình tạo trang tĩnh. Laravel chỉ là nơi phần lớn khách hàng headless của chúng tôi vận hành.

Không. API trả về HTML thân bài viết đã render sẵn, độc lập. Bạn bọc nó bằng layout và typography của riêng mình; tiêu đề, danh sách, hình ảnh, FAQ và khung chú thích đã được cấu trúc sẵn.

Đăng ký webhook nội dung. Khi có content.published hoặc content.updated, lấy bài viết bằng ID và upsert bản sao cục bộ. Slug và ID ổn định qua các lần làm mới.

Có, nhưng rộng rãi cho trường hợp này: đọc tiêu chuẩn cho phép 60 yêu cầu/phút mỗi khóa. Một lần đồng bộ xuất bản điển hình dùng một webhook và một lần lấy mỗi bài viết.

Frontend của bạn, pipeline biên tập của chúng tôi. Kết nối chúng trong một buổi tối.

Bắt đầu miễn phí Trao đổi với chúng tôi