API-first / headless

Porta gli articoli di ContentPulse nella tua app Laravel.

Gestisci il tuo frontend? ContentPulse è API-first. Collega la tua app Laravel con una chiave API, ascolta un webhook e mostra l'HTML dell'articolo pronto all'uso nelle tue viste Blade — le tue route, il tuo design, il tuo dominio.

Inizia gratis Vedi su GitHub Vedi i prezzi

Pacchetto ufficiale: composer require contentpulseio/laravel — oppure usa la semplice REST API da qualsiasi framework.

Configurazione in quattro passaggi

PASSAGGIO 1

Crea una chiave API

In ContentPulse, vai su Impostazioni › Chiavi API e crea una chiave per il tuo sito. Conservala nel file .env della tua app Laravel.

PASSAGGIO 2

Registra un webhook

In ContentPulse, aggiungi un webhook che punta alla tua app (es. /webhooks/contentpulse), iscritto a content.published. Firmiamo ogni consegna così puoi verificarne la provenienza.

PASSAGGIO 3

Recupera l'articolo

Quando il webhook scatta, chiama la nostra REST API con la tua chiave (header X-API-Key) per recuperare l'articolo: titolo, slug, metadati SEO, URL dell'immagine, coppie di FAQ e HTML pre-renderizzato.

PASSAGGIO 4

Renderizza nella tua vista Blade

Salva i dati e mostra {!! $article->rendered_html !!} nella tua vista. L'HTML è autonomo e indipendente dal tema — eredita la tua tipografia e i tuoi stili.

Cosa ti offre l'API

HTML dell'articolo pre-renderizzato

Ogni articolo include rendered_html — markup pulito e semantico senza classi di framework — da salvare e mostrare così com'è. Nessun parsing di sezioni né logica di template da parte tua.

Payload SEO completo

Meta title, meta description, slug, keyword e URL dell'immagine principale arrivano nella stessa risposta, pronti da inserire nel <head> del tuo layout.

Dati FAQ per JSON-LD

Le coppie domanda/risposta vengono estratte in un array faq strutturato, per generare JSON-LD FAQPage e puntare ai risultati avanzati.

Webhook firmati

Ricevi notifiche su content.published, content.updated e altro. Ogni consegna ha una firma HMAC così il tuo endpoint può verificarne l'autenticità.

Pensato per gli aggiornamenti

Quando ContentPulse aggiorna un articolo, ricevi un webhook di aggiornamento con gli stessi identificatori — aggiorna la tua copia locale sul posto, l'URL non cambia mai.

I tuoi link, il tuo dominio

Imposta l'URL del tuo hub risorse e i link interni degli articoli vengono riscritti verso il tuo dominio prima di arrivare all'API — nessun URL di ContentPulse finisce sul tuo sito.

Domande frequenti

No — è una semplice REST API con risposte JSON e webhook; qualsiasi stack funziona: Symfony, Rails, Django, Next.js o un generatore di siti statici. Laravel è semplicemente dove lavora la maggior parte dei nostri clienti headless.

No. L'API restituisce HTML pre-renderizzato e autonomo per il corpo dell'articolo. Lo avvolgi nel tuo layout e nella tua tipografia; titoli, elenchi, immagini, FAQ e box sono già strutturati.

Iscriviti ai webhook dei contenuti. Su content.published o content.updated, recupera l'articolo tramite il suo ID e inserisci o aggiorna la tua copia locale. Slug e ID restano stabili tra gli aggiornamenti.

Sì, con ampio margine per questo caso d'uso: le letture standard sono 60 richieste/minuto per chiave. Una sincronizzazione tipica usa un webhook e una richiesta per articolo.

Il tuo frontend, il nostro flusso editoriale. Collegali in un pomeriggio.

Inizia gratis Parla con noi