API أولًا / Headless

اجلب مقالات ContentPulse إلى تطبيق Laravel الخاص بك.

لديك واجهة أمامية خاصة؟ ContentPulse مبني على API أولًا. اربط تطبيق Laravel بمفتاح API واستمع إلى Webhook واعرض HTML المقالات الجاهز داخل قوالب Blade الخاصة بك — مساراتك وتصميمك ونطاقك.

ابدأ مجانًا عرض على GitHub عرض الأسعار

الحزمة الرسمية: composer require contentpulseio/laravel — أو استخدم REST API مباشرةً من أي إطار عمل.

الإعداد في أربع خطوات

الخطوة 1

أنشئ مفتاح API

في ContentPulse انتقل إلى الإعدادات › مفاتيح API وأنشئ مفتاحًا لموقعك. خزّنه في ملف .env في تطبيق Laravel.

الخطوة 2

سجّل Webhook

أضف Webhook في ContentPulse يشير إلى تطبيقك (مثل /webhooks/contentpulse) مشتركًا في content.published. نوقّع كل إرسال حتى تتحقق من أنه صادر منا.

الخطوة 3

اجلب المقال

عند وصول الـ Webhook، استدعِ REST API بمفتاحك (ترويسة X-API-Key) لجلب المقال: العنوان والمسار وبيانات SEO الوصفية ورابط الصورة وأزواج الأسئلة الشائعة وHTML المُصيَّر مسبقًا.

الخطوة 4

اعرضه في قالب Blade

خزّن الحمولة واعرض {!! $article->rendered_html !!} داخل القالب. الـ HTML مستقل ومحايد للتصميم — يرث خطوطك وأنماطك.

ما الذي تمنحك إياه واجهة API

HTML مقالات مُصيَّر مسبقًا

كل مقال يتضمن rendered_html — ترميز نظيف ودلالي بلا فئات أطر عمل — فتخزّنه وتعرضه فحسب. لا تحليل أقسام ولا منطق قوالب من جهتك.

حمولة SEO كاملة

يصل عنوان الميتا والوصف والمسار والكلمات المفتاحية ورابط الصورة الرئيسية في الاستجابة نفسها، جاهزة لوسم <head> في تخطيطك.

بيانات FAQ لـ JSON-LD

تُستخرج أزواج السؤال/الجواب في مصفوفة faq منظّمة، لتتمكن من إصدار JSON-LD لـ FAQPage واستهداف النتائج المنسّقة.

Webhooks موقّعة

استقبل إشعارات content.published وcontent.updated وغيرها. كل إرسال موقّع بـ HMAC حتى تتحقق نقطة النهاية لديك من صحته.

مصمم للتحديثات

عندما يُحدّث ContentPulse مقالًا تتلقى Webhook تحديث بنفس المعرّفات — حدّث نسختك المخزّنة في مكانها ولن يتغير URL أبدًا.

روابطك ونطاقك

اضبط رابط مركز المصادر لديك وستُعاد كتابة الروابط الداخلية في المقالات إلى نطاقك الخاص قبل وصولها إلى API — لا تتسرب أي روابط لـ ContentPulse إلى موقعك.

أسئلة شائعة

لا — إنها REST API عادية باستجابات JSON وWebhooks، لذا تعمل مع أي تقنية: Symfony أو Rails أو Django أو Next.js أو مولدات المواقع الثابتة. Laravel هو ببساطة ما يستخدمه معظم عملائنا في النمط Headless.

لا. تعيد API محتوى المقال كـ HTML مُصيَّر مسبقًا ومستقل. غلّفه بتخطيطك وخطوطك؛ العناوين والقوائم والصور والأسئلة الشائعة والمقتطفات منظمة سلفًا.

اشترك في Webhooks المحتوى. عند content.published أو content.updated اجلب المقال بمعرّفه وحدّث نسختك المحلية. المسارات والمعرّفات ثابتة عبر التحديثات.

نعم، وهي سخية لهذا الاستخدام: القراءات القياسية 60 طلبًا في الدقيقة لكل مفتاح. مزامنة النشر المعتادة هي Webhook واحد وجلب واحد لكل مقال.

واجهتك الأمامية وخط إنتاجنا التحريري. اربطهما في ظهيرة واحدة.

ابدأ مجانًا تحدّث إلينا