API 우선 / 헤드리스

ContentPulse 아티클을 여러분의 Laravel 앱으로.

자체 프런트엔드가 있으신가요? ContentPulse는 API 우선입니다. API 키로 Laravel 앱을 연결하고 웹훅을 수신한 뒤, 아티클의 완성된 HTML을 여러분의 Blade 뷰에서 렌더링하세요 — 여러분의 라우트, 여러분의 디자인, 여러분의 도메인으로요.

무료로 시작 GitHub에서 보기 요금 보기

공식 패키지: composer require contentpulseio/laravel — 또는 어떤 프레임워크에서든 간단한 REST API를 사용하세요.

4단계 설정

1단계

API 키 생성

ContentPulse에서 설정 › API 키로 이동해 웹사이트용 키를 생성하고 Laravel 앱의 .env에 저장하세요.

2단계

웹훅 등록

ContentPulse에서 앱을 가리키는 웹훅(예: /webhooks/contentpulse)을 추가하고 content.published를 구독하세요. 모든 전송에 서명이 포함되어 발신자를 검증할 수 있습니다.

3단계

아티클 가져오기

웹훅이 실행되면 키(X-API-Key 헤더)로 REST API를 호출해 아티클을 가져오세요: 제목, 슬러그, SEO 메타, 이미지 URL, FAQ 쌍, 사전 렌더링된 HTML.

4단계

Blade 뷰에서 렌더링

페이로드를 저장하고 뷰에서 {!! $article->rendered_html !!}를 출력하세요. HTML은 독립적이고 테마 중립적입니다 — 여러분의 타이포그래피와 스타일을 그대로 상속합니다.

API가 제공하는 것들

사전 렌더링된 아티클 HTML

모든 아티클에는 rendered_html이 포함됩니다 — 프레임워크 클래스 없는 깔끔하고 시맨틱한 마크업 — 저장하고 출력하기만 하면 됩니다. 섹션 파싱이나 템플릿 로직이 필요 없습니다.

완전한 SEO 페이로드

메타 제목, 메타 설명, 슬러그, 키워드, 대표 이미지 URL이 같은 응답에 담겨 도착해 레이아웃의 <head>에 바로 사용할 수 있습니다.

JSON-LD용 FAQ 데이터

질문/답변 쌍이 구조화된 faq 배열로 추출되어 FAQPage JSON-LD를 출력하고 리치 결과를 노릴 수 있습니다.

서명된 웹훅

content.published, content.updated 등의 알림을 받으세요. 모든 전송은 HMAC 서명되어 엔드포인트에서 진위를 확인할 수 있습니다.

새로 고침을 고려한 설계

ContentPulse가 아티클을 새로 고치면 같은 식별자로 업데이트 웹훅이 전송됩니다 — 로컬 사본을 제자리에서 업데이트하면 되고 URL은 절대 바뀌지 않습니다.

여러분의 링크, 여러분의 도메인

리소스 허브 URL을 설정하면 아티클 내부 링크가 API에 도달하기 전에 여러분의 도메인으로 재작성됩니다 — ContentPulse URL이 사이트에 노출되지 않습니다.

자주 묻는 질문

아니요 — JSON 응답과 웹훅을 갖춘 표준 REST API이므로 Symfony, Rails, Django, Next.js, 정적 사이트 생성기 등 어떤 스택에서도 작동합니다. Laravel은 저희 헤드리스 고객이 가장 많이 사용하는 것일 뿐입니다.

아니요. API가 아티클 본문을 사전 렌더링된 독립형 HTML로 반환합니다. 여러분의 레이아웃과 타이포그래피로 감싸기만 하세요. 제목, 목록, 이미지, FAQ, 강조가 모두 구조화되어 있습니다.

콘텐츠 웹훅을 구독하세요. content.published 또는 content.updated 시 ID로 아티클을 가져와 로컬 사본을 upsert하면 됩니다. 슬러그와 ID는 새로 고침 후에도 안정적으로 유지됩니다.

네, 이 용도로는 충분합니다: 표준 호출은 키당 분당 60회 요청입니다. 일반적인 게시 동기화는 아티클당 웹훅 1회와 가져오기 1회입니다.

여러분의 프런트엔드, 저희의 콘텐츠 파이프라인. 한나절이면 연결됩니다.

무료로 시작 문의하기