API-first / headless

הביאו מאמרי ContentPulse לאפליקציית ה-Laravel שלכם.

יש לכם frontend משלכם? ContentPulse הוא API-first. חברו את אפליקציית ה-Laravel עם מפתח API, האזינו ל-webhook ורנדרו את ה-HTML המוכן של המאמרים ב-Blade views שלכם, הנתיבים שלכם, העיצוב שלכם, הדומיין שלכם.

התחילו בחינם צפו ב-GitHub ראו תמחור

חבילה רשמית: composer require contentpulseio/laravel, או השתמשו ב-REST API הפשוט מכל framework.

הגדרה בארבעה שלבים

שלב 1

צרו מפתח API

ב-ContentPulse עברו אל הגדרות › מפתחות API וצרו מפתח לאתר שלכם. שמרו אותו בקובץ .env של אפליקציית ה-Laravel.

שלב 2

רשמו webhook

הוסיפו webhook ב-ContentPulse שמצביע לאפליקציה שלכם (למשל /webhooks/contentpulse) עם הרשמה ל-content.published. אנחנו חותמים על כל משלוח כדי שתוכלו לוודא שזה אנחנו.

שלב 3

משכו את המאמר

כשה-webhook מופעל, קראו ל-REST API שלנו עם המפתח (כותרת X-API-Key) כדי למשוך את המאמר: כותרת, slug, מטא SEO, כתובת תמונה, זוגות FAQ ו-HTML מרונדר מראש.

שלב 4

רנדרו ב-Blade view

שמרו את ה-payload והציגו {!! $article->rendered_html !!} ב-view שלכם. ה-HTML עצמאי וניטרלי לתבנית, הוא יורש את הטיפוגרפיה והסגנונות שלכם.

מה ה-API נותן לכם

HTML מאמר מרונדר מראש

כל מאמר כולל rendered_html (סימון נקי וסמנטי ללא מחלקות framework) כך שפשוט שומרים ומציגים. אין ניתוח מקטעים או לוגיקת תבניות בצד שלכם.

payload SEO מלא

כותרת מטא, תיאור מטא, slug, מילות מפתח וכתובת התמונה הראשית מגיעים באותה תשובה, מוכנים ל-<head> של ה-layout שלכם.

נתוני FAQ ל-JSON-LD

זוגות שאלה/תשובה מחולצים למערך faq מובנה, כך שתוכלו לפלוט FAQPage JSON-LD ולכוון ל-rich results.

webhooks חתומים

קבלו התראות על content.published, content.updated ועוד. כל משלוח חתום HMAC כך שה-endpoint שלכם יכול לאמת אותנטיות.

בנוי לרענונים

כש-ContentPulse מרענן מאמר, אתם מקבלים webhook עדכון עם אותם מזהים, עדכנו את העותק המקומי במקום, וכתובת ה-URL לעולם לא משתנה.

הקישורים שלכם, הדומיין שלכם

הגדירו את כתובת מרכז המשאבים שלכם וקישורים פנימיים במאמרים ייכתבו מחדש לדומיין שלכם לפני שהם מגיעים ל-API, אף כתובת ContentPulse לא דולפת לאתר שלכם.

שאלות נפוצות

לא, זה REST API רגיל עם תשובות JSON ו-webhooks, ולכן הוא עובד עם כל stack: Symfony, Rails, Django, Next.js או מחולל אתרים סטטי. Laravel הוא פשוט מה שרוב לקוחות ה-headless שלנו משתמשים בו.

לא. ה-API מחזיר את גוף המאמר כ-HTML מרונדר מראש ועצמאי. עוטפים אותו ב-layout ובטיפוגרפיה שלכם; כותרות, רשימות, תמונות, FAQ והדגשות כבר מובנים.

הירשמו ל-webhooks של תוכן. ב-content.published או content.updated משכו את המאמר לפי ה-ID ובצעו upsert לעותק המקומי. ה-slugs וה-IDs יציבים לאורך רענונים.

כן, נדיבות לשימוש הזה: קריאות סטנדרטיות הן 60 בקשות לדקה למפתח. סנכרון פרסום טיפוסי הוא webhook אחד ומשיכה אחת למאמר.

ה-frontend שלכם, צינור התוכן שלנו. חברו אותם באחר צהריים אחד.

התחילו בחינם דברו איתנו