API-first / headless

Загружайте статьи ContentPulse в ваше Laravel-приложение.

У вас свой фронтенд? ContentPulse построен по принципу API-first. Подключите ваше Laravel-приложение с помощью API-ключа, слушайте вебхук и выводите готовый HTML статей в собственных Blade-шаблонах — ваши маршруты, ваш дизайн, ваш домен.

Начать бесплатно Смотреть на GitHub Посмотреть цены

Официальный пакет: composer require contentpulseio/laravel — или используйте обычный REST API из любого фреймворка.

Настройка за четыре шага

ШАГ 1

Создайте API-ключ

В ContentPulse перейдите в Настройки › API-ключи и создайте ключ для вашего сайта. Сохраните его в файле .env вашего Laravel-приложения.

ШАГ 2

Зарегистрируйте вебхук

Добавьте в ContentPulse вебхук, указывающий на ваше приложение (например /webhooks/contentpulse), с подпиской на content.published. Мы подписываем каждую доставку, чтобы вы могли убедиться, что это мы.

ШАГ 3

Получите статью

Когда вебхук срабатывает, вызовите наш REST API с вашим ключом (заголовок X-API-Key), чтобы получить статью: заголовок, slug, SEO-мета, URL изображения, пары FAQ и предварительно отрендеренный HTML.

ШАГ 4

Выводите в вашем Blade-шаблоне

Сохраните данные и выведите {!! $article->rendered_html !!} в вашем шаблоне. HTML самодостаточен и нейтрален к теме — он наследует вашу типографику и стили.

Что даёт вам API

Предварительно отрендеренный HTML статьи

Каждая статья поставляется с rendered_html — чистой семантической разметкой без классов фреймворков — сохраняете и выводите. Никакого парсинга секций или логики шаблонов с вашей стороны.

Полный SEO-пакет

Мета-заголовок, мета-описание, slug, ключевые слова и URL главного изображения приходят в одном ответе, готовые для вставки в <head> вашего лейаута.

Данные FAQ для JSON-LD

Пары вопрос/ответ извлекаются в структурированный массив faq, чтобы вы могли выводить FAQPage JSON-LD и претендовать на расширенные результаты.

Подписанные вебхуки

Получайте уведомления о content.published, content.updated и других событиях. Каждая доставка подписана HMAC, поэтому ваш эндпоинт может проверить подлинность.

Поддержка обновлений по умолчанию

Когда ContentPulse обновляет статью, вы получаете вебхук обновления с теми же идентификаторами — обновите сохранённую копию на месте, и URL никогда не изменится.

Ваши ссылки, ваш домен

Укажите URL вашего ресурсного центра, и внутренние ссылки в статьях будут переписаны на ваш собственный домен ещё до попадания в API — никакие URL ContentPulse не просочатся на ваш сайт.

Частые вопросы

Нет — это обычный REST API с JSON-ответами и вебхуками, поэтому подойдёт любой стек: Symfony, Rails, Django, Next.js или генератор статических сайтов. Laravel — просто то, где работает большинство наших headless-клиентов.

Нет. API возвращает предварительно отрендеренный, самодостаточный HTML тела статьи. Вы оборачиваете его в собственный лейаут и типографику; заголовки, списки, изображения, FAQ и выноски уже структурированы.

Подпишитесь на вебхуки контента. При content.published или content.updated получите статью по её ID и обновите локальную копию. Slug и ID стабильны между обновлениями.

Да, щедрое для этого сценария: стандартные чтения — 60 запросов/минуту на ключ. Типичная синхронизация публикации использует один вебхук и один запрос на статью.

Ваш фронтенд, наш редакционный процесс. Соедините их за один вечер.

Начать бесплатно Связаться с нами