본문으로 건너뛰기

콘텐츠 등록 가이드 ​

콘솔에서 글의 틀을 만들고, 글을 쓰고, 발행해서 홈페이지로 내보내기까지의 흐름이에요. 아래 화면은 모두 콘솔의 콘텐츠 관리 → 콘텐츠 메뉴에서 진행해요.

콘텐츠 관리 메인 화면. 내 콘텐츠 종류 카드와 4단계 등록 가이드가 보인다

콘텐츠 관리 메인 — 내 콘텐츠 종류와 등록 가이드가 한 화면에 있어요.

1. 콘텐츠 종류 만들기 ​

블로그 글, 공지사항, FAQ처럼 홈페이지에 올릴 글의 틀(콘텐츠 타입) 을 먼저 만들어요. 우측 상단 새 콘텐츠 종류 버튼을 누르면 2단계 모달이 열려요.

타입 이름은 메뉴에 표시될 이름이고, 슬러그는 API 경로와 콘솔 URL에 쓰이는 식별자예요. 영문·숫자·밑줄만 쓸 수 있고 만든 뒤에는 바꾸지 않는 게 좋아요.

새 콘텐츠 종류 모달 1단계. 타입 이름에 FAQ, 슬러그에 faq가 입력돼 있다

1단계 기본 정보 — 이름과 슬러그를 정해요.

다음을 누르면 항목 구성 단계예요. 제목 항목은 기본으로 포함되고 이름만 바꿀 수 있어요. 항목 추가로 본문·답변 같은 항목을 더하고, 각 항목의 필드 ID를 정해요. 필드 ID는 API 응답의 values 키로 그대로 쓰여요.

새 콘텐츠 종류 모달 2단계. 제목 항목 '질문'과 추가 항목 '답변(answer)'이 있다

2단계 항목 구성 — 제목 항목 이름을 바꾸고 필요한 항목을 추가해요.

만들면 왼쪽 콘텐츠 메뉴 아래에 바로 추가돼요. 여기서 정한 슬러그가 콘텐츠 조회 경로의 :content_type 자리에 들어가요.

2. 입력 항목 구성하기 ​

항목은 나중에도 바꿀 수 있어요. 종류 화면 우측 상단 항목 설정에서 항목을 추가·수정하고, 드래그나 ⌃⌄ 버튼으로 순서를 바꿔요. 변경은 저장을 눌러야 반영돼요.

blog 항목 설정 화면. Title, Slug, Body, Cover 네 항목이 순서대로 나열돼 있다

항목 설정 — 제목 항목은 삭제할 수 없고, 나머지는 자유롭게 바꿔요.

지원하는 항목 타입은 아래와 같아요. 타입별 값 형식은 데이터 모델을 참고하세요.

항목 타입쓰임API 값
한 줄 텍스트제목, 짧은 문구string
슬러그 (주소)글 URL 식별자string
여러 줄 텍스트요약, 짧은 설명string
본문 (서식 편집)글 본문리치 텍스트 문서(JSON)
숫자가격, 순서number
이미지대표 이미지미디어 에셋 id
날짜행사일, 게시일YYYY-MM-DD
예 / 아니오노출 여부 같은 토글boolean

3. 콘텐츠 작성하기 ​

종류 화면에서 + 추가를 누르면 작성 모달이 열려요. 제목을 쓰면 제목에서 버튼으로 슬러그를 자동으로 만들 수 있고, 본문은 서식 편집기로 작성해요. 이미지는 미디어에 올려둔 파일 중에서 골라요.

새 blog 콘텐츠 작성 모달. 제목과 슬러그가 입력돼 있고 본문 편집기와 이미지 선택 영역이 보인다

작성 모달 — 만들기를 누르면 초안으로 저장되고 상세 화면으로 이동해요.

만들어진 글은 초안(draft) 상태예요. 목록에서는 상태별 배지로 구분되고, 제목 검색과 상태 필터로 찾을 수 있어요.

blog 콘텐츠 목록. 보관됨·초안·예약·변경됨·발행됨 상태 배지가 행마다 표시된다

콘텐츠 목록 — 상태 배지로 발행 여부를 한눈에 볼 수 있어요.

4. 발행하기 ​

상세 화면 오른쪽 상태 패널에서 발행을 관리해요. 초안에서는 발행, 예약 발행, 보관 세 가지를 고를 수 있어요. 발행하려면 필수 항목(제목 등)이 채워져 있어야 해요.

초안 상태의 콘텐츠 상세. 오른쪽 상태 패널에 발행, 예약 발행, 보관 버튼이 있다

초안 상세 — 왼쪽에서 내용을 고치고 오른쪽에서 상태를 바꿔요.

예약 발행을 누르면 발행 시각을 고르는 창이 떠요. 예약된 글은 그 시각에 자동으로 발행돼요.

예약 발행 시각 모달. 날짜와 시각을 고르는 입력과 예약 버튼이 있다

예약 발행 — 시각을 고르고 예약을 누르면 상태가 예약으로 바뀌어요.

발행된 글은 홈페이지에서 바로 보여요. 발행 후 내용을 고치면 상태가 변경됨으로 바뀌고, 고친 내용이 API 응답에 바로 반영돼요. 상태 전이 규칙은 콘텐츠 발행 흐름에 정리돼 있어요.

발행됨 상태의 콘텐츠 상세. 상태 패널에 발행 취소 버튼과 발행·수정·생성 활동 기록이 있다

발행됨 상세 — 활동 기록에서 발행 시각을 확인할 수 있어요.

5. 홈페이지에 연결하기 ​

발행된 콘텐츠는 API 키로 가져와요. 설정 → API 키 관리에서 키를 발급하고, 아래처럼 호출하면 발행된 글만 내려와요. 초안·예약·보관된 글은 포함되지 않아요.

bash
curl https://api.cherpa.me/v1/content/blog/entries \
  -H "Authorization: Bearer chp_..."

응답 형식과 필터는 콘텐츠 조회, 키 발급은 API 키를 참고하세요.