BookSpecs 가이드

포토북 상품 스펙(판형)의 종류와 특징을 안내하고, 목적에 맞는 판형을 선택하는 방법을 설명합니다.

상품 스펙(BookSpec)이란?

상품 스펙은 포토북의 물리적 제작 사양을 정의합니다. 판형 크기, 제본 방식, 표지 유형, 페이지 범위, 가격 등의 정보를 포함합니다. 책을 생성할 때 bookSpecUid를 지정하며, 이후 사용할 수 있는 템플릿과 페이지 규칙이 이 스펙에 의해 결정됩니다.

판형 종류

현재 제공되는 주요 판형입니다. GET /book-specs로 전체 목록을 조회할 수 있습니다.

고화질 스퀘어북

SQUAREBOOK_HC

내지 크기	243 x 248 mm
표지	Hardcover (하드커버)
제본	PUR (무선철)
페이지	24 ~ 130 페이지 (2페이지씩 증가)
기본 가격	19,800원 (24페이지 기준)
추가 비용	2페이지당 500원

가장 범용적인 판형입니다. 많은 페이지를 담을 수 있어 앨범, 일기장, 졸업앨범 등 다양한 용도에 적합합니다.

레이플랫북

LAYFLAT_HC

내지 크기	243 x 248 mm
표지	Hardcover (하드커버)
제본	LAYFLAT (레이플랫)
페이지	16 ~ 46 페이지 (2페이지씩 증가)

180도로 완전히 펼쳐지는 제본 방식입니다. 양면 펼침 사진이 끊김 없이 보여, 웨딩 앨범이나 사진집에 적합합니다.

슬림앨범

SLIMALBUM_HC

내지 크기	243 x 248 mm
표지	Hardcover (하드커버)
제본	SLIMALBUM (슬림앨범)
페이지	20 ~ 30 페이지 (2페이지씩 증가)

간결한 분량의 앨범입니다. 소규모 이벤트 기록이나 선물용으로 적합합니다.

스펙 조회하기

목록 조회

bash

curl 'https://api.sweetbook.com/v1/book-specs' \
  -H 'Authorization: Bearer YOUR_API_KEY'

상세 조회

bash

curl 'https://api.sweetbook.com/v1/book-specs/SQUAREBOOK_HC' \
  -H 'Authorization: Bearer YOUR_API_KEY'

주요 응답 필드

필드	설명
`bookSpecUid`	상품 스펙 고유 식별자 (책 생성 시 사용)
`name`	상품명
`innerTrimWidthMm` / `innerTrimHeightMm`	내지 크기 (mm)
`pageMin` / `pageMax`	페이지 범위
`pageIncrement`	페이지 증가 단위
`coverType`	표지 유형 (예: Hardcover)
`bindingType`	제본 유형 (PUR, LAYFLAT, SLIMALBUM 등)
`priceBase`	기본 가격
`pricePerIncrement`	페이지 증가당 추가 가격
`layoutSize`	레이아웃 작업 영역 크기 (표지/내지 width, height)

가격 계산

제작 가격은 기본 가격에 추가 페이지 비용을 더해 산출됩니다.

text

총 가격 = priceBase + ((pageCount - pageMin) ÷ pageIncrement) × pricePerIncrement

예시: SQUAREBOOK_HC, 40페이지
  기본 가격: 19,800원 (24페이지 포함)
  추가 페이지: (40 - 24) = 16페이지
  추가 비용: (16 ÷ 2) × 500 = 4,000원
  총 가격: 19,800 + 4,000 = 23,800원

실제 주문 가격은 POST /orders/estimate로 확인하세요. 수량, 포장비, 배송비 등 추가 요소가 반영될 수 있습니다.

페이지 규칙

책을 최종화(POST /books/{bookUid}/finalization)할 때 페이지 수가 스펙의 규칙을 충족해야 합니다.

페이지 수는 pageMin 이상, pageMax 이하여야 합니다.
페이지 수는 pageIncrement 단위로 증가해야 합니다 (예: 24, 26, 28, ...).
규칙에 맞지 않으면 최종화가 거부됩니다.

판형 선택 가이드

용도	추천 판형	이유
일기장 / 알림장	SQUAREBOOK_HC	많은 페이지(최대 130p)를 담을 수 있어 일별 기록에 적합
웨딩 앨범 / 사진집	LAYFLAT_HC	180도 펼침으로 양면 사진이 자연스럽게 연결
선물용 / 소규모 앨범	SLIMALBUM_HC	간결한 분량(20~30p)으로 부담 없는 구성
졸업앨범 / 범용	SQUAREBOOK_HC	유연한 페이지 범위와 합리적 가격