API-first / headless

ดึงบทความ ContentPulse เข้าสู่แอป Laravel ของคุณ

คุณเป็นเจ้าของ frontend เอง? ContentPulse ถูกสร้างแบบ API-first เชื่อมต่อแอป Laravel ของคุณด้วย API key ฟัง webhook และแสดงผล HTML บทความที่เสร็จแล้วใน Blade view ของคุณเอง — เส้นทางของคุณ ดีไซน์ของคุณ โดเมนของคุณ

แพ็กเกจอย่างเป็นทางการ: composer require contentpulseio/laravel — หรือใช้ REST API ธรรมดาจากเฟรมเวิร์กใดก็ได้

ตั้งค่าใน 4 ขั้นตอน

ขั้นตอนที่ 1

สร้าง API key

ใน ContentPulse ไปที่ การตั้งค่า › API Keys และสร้างคีย์สำหรับเว็บไซต์ของคุณ เก็บไว้ในไฟล์ .env ของแอป Laravel

ขั้นตอนที่ 2

ลงทะเบียน webhook

เพิ่ม webhook ใน ContentPulse ชี้ไปที่แอปของคุณ (เช่น /webhooks/contentpulse) สมัครรับ content.published เราลงนามทุกการส่งเพื่อให้คุณยืนยันได้ว่าเป็นเรา

ขั้นตอนที่ 3

ดึงบทความ

เมื่อ webhook ทำงาน เรียก REST API ของเราด้วยคีย์ของคุณ (เฮดเดอร์ X-API-Key) เพื่อดึงบทความ: ชื่อเรื่อง slug เมตา SEO URL รูปภาพ คู่ FAQ และ HTML ที่เรนเดอร์ล่วงหน้า

ขั้นตอนที่ 4

แสดงผลใน Blade view ของคุณ

เก็บสิ่งที่ต้องการแล้วแสดงผล {!! $article->rendered_html !!} ในเทมเพลตของคุณ HTML สมบูรณ์ในตัวและเป็นกลางต่อธีม — รับการจัดรูปแบบตัวอักษรและสไตล์ของคุณ

สิ่งที่ API มอบให้คุณ

HTML บทความที่เรนเดอร์ล่วงหน้า

ทุกบทความมาพร้อม rendered_html — มาร์กอัปเชิงความหมายที่สะอาดไม่มีคลาสเฟรมเวิร์ก — เก็บแล้วแสดงผลได้เลย ไม่ต้องแยกวิเคราะห์ส่วนหรือเขียนลอจิกเทมเพลตฝั่งคุณ

แพ็กเกจ SEO ครบชุด

ชื่อเมตา คำอธิบายเมตา slug คีย์เวิร์ด และ URL ภาพเด่นมาในการตอบกลับเดียวกัน พร้อมใส่ใน <head> ของเลย์เอาต์คุณ

ข้อมูล FAQ สำหรับ JSON-LD

คู่คำถาม/คำตอบถูกแยกเป็นอาร์เรย์ faq ที่มีโครงสร้าง เพื่อให้คุณแสดงผล FAQPage JSON-LD และแข่งขันชิง rich results ได้

Webhook ที่ลงนาม

รับการแจ้งเตือน content.published, content.updated และอื่นๆ ทุกการส่งลงนามด้วย HMAC เพื่อให้ endpoint ของคุณยืนยันความถูกต้องได้

รองรับการรีเฟรชโดยค่าเริ่มต้น

เมื่อ ContentPulse รีเฟรชบทความ คุณจะได้รับ webhook การอัปเดตพร้อมตัวระบุเดิม — อัปเดตสำเนาที่เก็บไว้ในตำแหน่งเดิม URL ไม่เปลี่ยนแปลง

ลิงก์ของคุณ โดเมนของคุณ

บอก URL ศูนย์ทรัพยากรของคุณกับเรา แล้วลิงก์ภายในในบทความจะถูกเขียนใหม่ให้ชี้ไปที่โดเมนของคุณเองก่อนถึง API — ไม่มี URL ของ ContentPulse หลุดเข้าเว็บไซต์คุณ

คำถามที่พบบ่อย

ไม่ &mdash; นี่คือ REST API ธรรมดาที่ตอบกลับเป็น JSON พร้อม webhook ดังนั้นใช้ได้กับทุกสแต็ก: Symfony, Rails, Django, Next.js หรือเครื่องมือสร้างเว็บไซต์แบบสแตติก Laravel เป็นเพียงที่ที่ลูกค้า headless ส่วนใหญ่ของเราใช้งาน
ไม่ API คืน HTML เนื้อหาบทความที่เรนเดอร์ล่วงหน้าและสมบูรณ์ในตัว คุณห่อด้วยเลย์เอาต์และการจัดรูปแบบตัวอักษรของคุณเอง หัวข้อ รายการ รูปภาพ FAQ และกล่องข้อความถูกจัดโครงสร้างไว้แล้ว
สมัครรับ webhook เนื้อหา เมื่อมี content.published หรือ content.updated ดึงบทความด้วย ID แล้ว upsert สำเนาในเครื่องของคุณ slug และ ID คงที่ตลอดการรีเฟรช
มี แต่ใจกว้างสำหรับกรณีใช้งานนี้: การอ่านมาตรฐานอนุญาต 60 คำขอ/นาทีต่อคีย์ การซิงค์การเผยแพร่ทั่วไปใช้ webhook หนึ่งครั้งและการดึงหนึ่งครั้งต่อบทความ

Frontend ของคุณ ไปป์ไลน์บรรณาธิการของเรา เชื่อมต่อกันได้ในเย็นเดียว

Cookie Notice

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