BookSpecs API

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

판형(BookSpec)이란?

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

판형 종류

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

판형 조회하기

목록 조회

사용 가능한 모든 판형 목록을 조회합니다. 각 상품의 UID, 이름, 바인딩 타입, 페이지 규칙 등이 반환됩니다.

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

상세 조회

bookSpecUid로 특정 판형의 상세 정보를 조회합니다. 가격 정보, 페이지 제한(최소/최대/단위), 크기 정보가 포함됩니다.

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

주요 응답 필드

가격 계산

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

총 가격 = 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 /books/{bookUid}/finalization)할 때 페이지 수가 스펙의 규칙을 충족해야 합니다.

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

판형 선택 가이드

관련 문서

• Books — PDF 기반 — PDF 방식 책 생성 시 bookSpecUid 사용
• Books — 템플릿 기반 — 템플릿 방식 책 생성 시 bookSpecUid 사용
• Templates API — 판형에 맞는 템플릿 선택
• Orders API — 가격 견적 및 주문