API-first / headless

Pobieraj artykuły ContentPulse do swojej aplikacji Laravel.

Masz własny frontend? ContentPulse jest API-first. Połącz swoją aplikację Laravel kluczem API, nasłuchuj webhooka i renderuj gotowy HTML artykułów we własnych widokach Blade — Twoje trasy, Twój design, Twoja domena.

Zacznij za darmo Zobacz na GitHub Zobacz cennik

Oficjalny pakiet: composer require contentpulseio/laravel — lub użyj zwykłego REST API z dowolnego frameworka.

Konfiguracja w czterech krokach

KROK 1

Utwórz klucz API

W ContentPulse przejdź do Ustawienia › Klucze API i utwórz klucz dla swojej strony. Zapisz go w pliku .env swojego Laravela.

KROK 2

Zarejestruj webhook

Dodaj webhook w ContentPulse wskazujący na Twoją aplikację (np. /webhooks/contentpulse) zasubskrybowany na content.published. Podpisujemy każdą dostawę, więc możesz zweryfikować, że to my.

KROK 3

Pobierz artykuł

Gdy webhook się uruchomi, wywołaj nasze REST API ze swoim kluczem (nagłówek X-API-Key), aby pobrać artykuł: tytuł, slug, meta SEO, URL obrazu, pary FAQ i wstępnie wyrenderowany HTML.

KROK 4

Renderuj w widoku Blade

Zapisz payload i wyświetl {!! $article->rendered_html !!} w swoim widoku. HTML jest samodzielny i neutralny wobec motywu — dziedziczy Twoją typografię i style.

Co daje Ci API

Wstępnie wyrenderowany HTML artykułu

Każdy artykuł zawiera rendered_html — czysty, semantyczny kod bez klas frameworkowych — więc zapisujesz go i wyświetlasz. Bez parsowania sekcji i logiki szablonów po Twojej stronie.

Pełny payload SEO

Meta tytuł, meta opis, slug, słowa kluczowe i URL obrazu głównego przychodzą w tej samej odpowiedzi, gotowe do umieszczenia w <head> Twojego layoutu.

Dane FAQ dla JSON-LD

Pary pytanie/odpowiedź są wyodrębniane do ustrukturyzowanej tablicy faq, więc możesz emitować JSON-LD FAQPage i celować w rich results.

Podpisane webhooki

Otrzymuj powiadomienia o content.published, content.updated i innych. Każda dostawa jest podpisana HMAC, więc Twój endpoint może zweryfikować autentyczność.

Zaprojektowane z myślą o odświeżeniach

Gdy ContentPulse odświeża artykuł, otrzymujesz webhook aktualizacji z tymi samymi identyfikatorami — zaktualizuj zapisaną kopię w miejscu, a URL nigdy się nie zmienia.

Twoje linki, Twoja domena

Ustaw URL swojego centrum zasobów, a linki wewnętrzne w artykułach są przepisywane na Twoją własną domenę, zanim trafią do API — żadne adresy ContentPulse nie wyciekają na Twoją stronę.

Częste pytania

Nie — to zwykłe REST API z odpowiedziami JSON i webhookami, więc działa z każdym stosem: Symfony, Rails, Django, Next.js czy generatorem stron statycznych. Laravel to po prostu środowisko większości naszych klientów headless.

Nie. API zwraca wstępnie wyrenderowany, samodzielny HTML treści artykułu. Otaczasz go własnym layoutem i typografią; nagłówki, listy, obrazy, FAQ i wyróżnienia są już ustrukturyzowane.

Zasubskrybuj webhooki treści. Przy content.published lub content.updated pobierz artykuł po jego ID i wykonaj upsert lokalnej kopii. Slugi i ID są stabilne między odświeżeniami.

Tak, hojne dla tego zastosowania: standardowe odczyty to 60 zapytań/minutę na klucz. Typowa synchronizacja publikacji to jeden webhook i jedno pobranie na artykuł.

Twój frontend, nasz proces redakcyjny. Połącz je w jedno popołudnie.

Zacznij za darmo Porozmawiaj z nami