API-first / headless

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

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

เริ่มต้นฟรี ดูบน GitHub ดูราคา

แพ็กเกจอย่างเป็นทางการ: 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 หลุดเข้าเว็บไซต์คุณ

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

ไม่ นี่คือ 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 ของคุณ ไปป์ไลน์บรรณาธิการของเรา เชื่อมต่อกันได้ในเย็นเดียว

เริ่มต้นฟรี คุยกับเรา