API-first / headless

Traga artigos do ContentPulse para a sua aplicação Laravel.

Tem o seu próprio frontend? O ContentPulse é API-first. Ligue a sua aplicação Laravel com uma chave de API, escute um webhook e renderize HTML de artigos pronto a usar nas suas próprias views Blade — as suas rotas, o seu design, o seu domínio.

Comece gratuitamente Ver no GitHub Ver preços

Pacote oficial: composer require contentpulseio/laravel — ou use a REST API simples a partir de qualquer framework.

Configuração em quatro passos

PASSO 1

Crie uma chave de API

No ContentPulse, vá a Definições › Chaves de API e crie uma chave para o seu site. Guarde-a no .env do seu Laravel.

PASSO 2

Registe um webhook

Adicione um webhook no ContentPulse a apontar para a sua aplicação (p. ex. /webhooks/contentpulse) subscrito a content.published. Assinamos cada entrega para que possa verificar que somos nós.

PASSO 3

Obtenha o artigo

Quando o webhook dispara, chame a nossa REST API com a sua chave (cabeçalho X-API-Key) para obter o artigo: título, slug, meta SEO, URL da imagem, pares de FAQ e HTML pré-renderizado.

PASSO 4

Renderize na sua view Blade

Guarde o payload e imprima {!! $article->rendered_html !!} na sua view. O HTML é autónomo e neutro em termos de tema — herda a sua tipografia e estilos.

O que a API lhe dá

HTML de artigo pré-renderizado

Cada artigo inclui rendered_html — markup limpo e semântico sem classes de framework — para que o guarde e o imprima. Sem parsing de secções nem lógica de receitas do seu lado.

Payload SEO completo

O meta título, a meta descrição, o slug, as palavras-chave e o URL da imagem de destaque vêm na mesma resposta, prontos a colocar no <head> do seu layout.

Dados de FAQ para JSON-LD

Os pares pergunta/resposta são extraídos para um array estruturado faq para que possa emitir JSON-LD FAQPage e visar rich results.

Webhooks assinados

Seja notificado em content.published, content.updated e mais. Cada entrega é assinada com HMAC para que o seu endpoint possa verificar a autenticidade.

Preparado para atualizações

Quando o ContentPulse atualiza um artigo, recebe um webhook de atualização com os mesmos identificadores — atualize a sua cópia local no sítio e o URL nunca muda.

Os seus links, o seu domínio

Defina o URL do seu centro de recursos e os links internos dentro dos artigos são reescritos para o seu próprio domínio antes de chegarem à API — nenhum URL do ContentPulse aparece no seu site.

Perguntas frequentes

Não — é uma REST API simples com respostas JSON e webhooks, por isso qualquer stack funciona: Symfony, Rails, Django, Next.js ou um gerador de sites estáticos. O Laravel é simplesmente onde a maioria dos nossos clientes headless trabalha.

Não. A API devolve HTML pré-renderizado e autónomo para o corpo do artigo. Envolve-o no seu próprio layout e tipografia; títulos, listas, imagens, FAQs e destaques já vêm estruturados.

Subscreva os webhooks de conteúdo. Em content.published ou content.updated, obtenha o artigo pelo seu ID e faça upsert da sua cópia local. Os slugs e IDs são estáveis entre atualizações.

Sim, generosos para este caso de uso: as leituras padrão são 60 pedidos/minuto por chave. Uma sincronização de publicação típica usa um webhook e um pedido por artigo.

O seu frontend, o nosso fluxo editorial. Ligue-os numa tarde.

Comece gratuitamente Fale connosco