홈▸개발문서▸워크플로우▸Step 1: BookSpec

Step 1: 상품(BookSpec) 선택

포토북 제작의 첫 단계는 상품 스펙(판형)을 선택하는 것입니다. 상품 스펙에 따라 사용 가능한 템플릿, 페이지 범위, 제본 방식이 결정됩니다.

개요

BookSpec은 포토북의 물리적 사양을 정의합니다. 판형 크기, 제본 방식, 표지 유형, 페이지 범위 등의 정보를 포함하며, 책을 생성할 때 반드시 하나의 BookSpec을 지정해야 합니다.

BookSpec을 선택하면 이후 단계에서 해당 스펙에 호환되는 템플릿만 사용할 수 있습니다.

상품 목록 조회

GET /book-specs로 사용 가능한 전체 상품 목록을 조회합니다.

bash
curl 'https://api.sweetbook.com/v1/book-specs' \
  -H 'Authorization: Bearer YOUR_API_KEY'
json
{
  "success": true,
  "message": "Success",
  "data": {
    "items": [
      {
        "bookSpecUid": "SQUAREBOOK_HC",
        "name": "고화질 스퀘어북",
        "innerTrimWidthMm": 243,
        "innerTrimHeightMm": 248,
        "coverType": "Hardcover",
        "bindingType": "PUR",
        "pageMin": 24,
        "pageMax": 130,
        "pageIncrement": 2
      },
      {
        "bookSpecUid": "LAYFLAT_HC",
        "name": "레이플랫북",
        "innerTrimWidthMm": 243,
        "innerTrimHeightMm": 248,
        "coverType": "Hardcover",
        "bindingType": "LAYFLAT",
        "pageMin": 16,
        "pageMax": 46,
        "pageIncrement": 2
      }
    ]
  }
}

상세 조회

GET /book-specs/{specUid}로 특정 상품의 상세 정보를 조회합니다. 가격 정보와 레이아웃 크기 등 추가 정보가 포함됩니다.

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

주요 필드 설명

필드타입설명
bookSpecUidstring상품 스펙 고유 식별자. 책 생성 시 이 값을 사용합니다.
namestring상품명 (예: 고화질 스퀘어북, 레이플랫북)
innerTrimWidthMm / innerTrimHeightMmnumber내지 크기 (mm 단위)
pageMin / pageMaxnumber허용 페이지 범위. 최종화 시 이 범위 내여야 합니다.
pageIncrementnumber페이지 증가 단위 (예: 2페이지씩 증가)
coverTypestring표지 유형 (예: Hardcover)
bindingTypestring제본 방식 (PUR, LAYFLAT, SLIMALBUM 등)
priceBasenumber기본 가격 (최소 페이지 기준)
pricePerIncrementnumber페이지 증가당 추가 가격
layoutSizeobject레이아웃 작업 영역 크기 (표지/내지 width, height)

가격 안내

Sandbox 환경: 테스트용 가격(100원 미만)이 적용됩니다. 실제 서비스 가격과 다릅니다.
Live 환경: 실제 가격은 SweetBook과의 개별 협의를 통해 결정됩니다. 영업팀에 문의해 주세요.

용도별 선택 가이드

서비스 특성에 맞는 상품을 선택하세요.

용도추천 상품이유
일기장 / 알림장SQUAREBOOK_HC최대 130페이지로 한 달치 일기를 충분히 담을 수 있음
웨딩 앨범 / 사진집LAYFLAT_HC180도 펼침으로 양면 사진이 끊김 없이 연결됨
선물용 / 소규모 앨범SLIMALBUM_HC20~30페이지의 간결한 구성으로 부담 없는 분량
졸업앨범 / 범용SQUAREBOOK_HC유연한 페이지 범위와 합리적 가격

다음 단계