API-first / headless

Tuo ContentPulse-artikkelit Laravel-sovellukseesi.

Onko sinulla oma frontend? ContentPulse on API-first. Yhdistä Laravel-sovelluksesi API-avaimella, kuuntele webhookia ja renderöi artikkelien valmis HTML omissa Blade-näkymissäsi — omat reittisi, oma designisi, oma domainisi.

Aloita ilmaiseksi Katso GitHubissa Katso hinnoittelu

Virallinen paketti: composer require contentpulseio/laravel — tai käytä pelkkää REST-API:a mistä tahansa frameworkista.

Määritys neljässä vaiheessa

VAIHE 1

Luo API-avain

Siirry ContentPulsessa kohtaan Asetukset › API-avaimet ja luo avain sivustollesi. Tallenna se Laravel-sovelluksesi .env-tiedostoon.

VAIHE 2

Rekisteröi webhook

Lisää ContentPulsessa webhook, joka osoittaa sovellukseesi (esim. /webhooks/contentpulse) ja tilaa content.published. Allekirjoitamme jokaisen toimituksen, jotta voit varmistaa, että se tulee meiltä.

VAIHE 3

Hae artikkeli

Kun webhook laukeaa, kutsu REST-API:amme avaimellasi (X-API-Key-otsake) ja hae artikkeli: otsikko, slug, SEO-meta, kuvan URL, FAQ-parit ja esirenderöity HTML.

VAIHE 4

Renderöi Blade-näkymässä

Tallenna payload ja näytä {!! $article->rendered_html !!} näkymässäsi. HTML on itsenäinen ja teemaneutraali — se perii typografiasi ja tyylisi.

Mitä API tarjoaa sinulle

Esirenderöity artikkeli-HTML

Jokainen artikkeli sisältää rendered_html-kentän — puhdasta, semanttista merkkausta ilman framework-luokkia — joten tallennat ja näytät sen sellaisenaan. Ei osioiden jäsennystä tai mallipohjalogiikkaa sinun puolellasi.

Täysi SEO-payload

Metaotsikko, metakuvaus, slug, avainsanat ja pääkuvan URL tulevat samassa vastauksessa, valmiina layoutisi <head>-osioon.

FAQ-data JSON-LD:tä varten

Kysymys/vastaus-parit poimitaan rakenteiseen faq-taulukkoon, joten voit tuottaa FAQPage JSON-LD:n ja tavoitella rich results -tuloksia.

Allekirjoitetut webhookit

Saat ilmoitukset tapahtumista content.published, content.updated ja muista. Jokainen toimitus on HMAC-allekirjoitettu, joten endpointtisi voi varmistaa aitouden.

Rakennettu päivityksiä varten

Kun ContentPulse päivittää artikkelin, saat päivitys-webhookin samoilla tunnisteilla — päivitä paikallinen kopiosi paikallaan, eikä URL koskaan muutu.

Sinun linkkisi, sinun domainisi

Aseta resurssikeskuksesi URL, niin artikkelien sisäiset linkit kirjoitetaan uudelleen omaan domainiisi ennen API:in saapumista — ContentPulse-URL:eja ei vuoda sivustollesi.

Yleisiä kysymyksiä

Ei — kyseessä on tavallinen REST-API JSON-vastauksilla ja webhookeilla, joten se toimii minkä tahansa stackin kanssa: Symfony, Rails, Django, Next.js tai staattinen sivugeneraattori. Laravel on vain se, mitä useimmat headless-asiakkaamme käyttävät.

Ei. API palauttaa artikkelin rungon esirenderöitynä, itsenäisenä HTML:nä. Käärit sen omaan layouttiisi ja typografiaasi; otsikot, listat, kuvat, FAQ:t ja nostot ovat jo rakenteistettuja.

Tilaa sisältöwebhookit. Tapahtumissa content.published tai content.updated hae artikkeli ID:llä ja tee upsert paikalliseen kopioosi. Slugit ja ID:t pysyvät vakaina päivitysten yli.

Kyllä, tähän käyttöön anteliaita: vakioluku on 60 pyyntöä/minuutti per avain. Tyypillinen julkaisusynkronointi on yksi webhook ja yksi haku per artikkeli.

Sinun frontendisi, meidän toimituksellinen putkemme. Yhdistä ne yhdessä iltapäivässä.

Aloita ilmaiseksi Ota yhteyttä