환경 (Sandbox / Live)
Book Print API는 Sandbox와 Live 두 가지 환경을 제공합니다. 각 환경은 완전히 분리되어 있으며, API Key와 Base URL이 다릅니다.
API Base URL
Sandbox와 Live의 Base URL이 다릅니다. 환경이 맞지 않을 때 반환되는 응답은 두 가지로 구분됩니다.
- 환경 불일치 Key (403
ERR_ENV_MISMATCH) — Sandbox 전용 Key로 Live URL을 호출하거나 반대의 경우 - Personal 계정의 Live 호출 (403) — Business 계정 전환 전까지는 Live 환경 사용 불가
응답 본문 포맷은 에러 코드 & 트러블슈팅 문서를 참고하세요.
| 환경 | Base URL |
|---|---|
| Sandbox | https://api-sandbox.sweetbook.com/v1 |
| Live | https://api.sweetbook.com/v1 |
서버는 요청 도메인을 기반으로 환경을 자동 판별합니다. 별도의 환경 파라미터가 필요하지 않습니다.
Request
curl -X GET 'https://api-sandbox.sweetbook.com/v1/book-specs' \
-H "Authorization: Bearer {YOUR_API_KEY}"환경별 차이
| 항목 | Sandbox | Live |
|---|---|---|
| Base URL | api-sandbox.sweetbook.com | api.sweetbook.com |
| API Key | Sandbox 전용 키 | Live 전용 키 |
| 충전금 | Sandbox 충전금 (파트너 포털에서 충전) | 실제 충전금 (결제로 충전) |
| 가격 | 판형별 단가 (운영과 동일, sandboxPriceBase + sandboxPricePerIncrement × 페이지) | 운영 적용가 (priceBase/pricePerIncrement, 협의 시 커스텀가 반영) |
| 실제 인쇄 | 하지 않음 | 실제 인쇄 진행 |
| 실제 배송 | 하지 않음 | 지정 택배사 배송 (평균 3~4 영업일 출고) |
| 웹훅 | 발생함 | 발생함 |
| 주문 상태 | 결제완료(PAID)에서 멈춤 (이후 전이 없음) | 결제완료 → 제작 → 출고 → 배송완료 전체 흐름 진행 |
| 데이터 | Sandbox 전용 (Live와 완전 분리) | Live 전용 |
계정 타입별 환경 접근
가입 시 Personal 계정이 생성되며, 사업 협의 완료 후 Business 계정으로 전환됩니다.
| 계정 타입 | Sandbox | Live | 전환 조건 |
|---|---|---|---|
| Personal | 사용 가능 | 사용 불가 | 가입 즉시 |
| Business | 사용 가능 | 사용 가능 | 스위트북과 사업 협의 완료 후 |
Sandbox 환경 상세
Sandbox 충전금
- 파트너 포털 > 충전금 > 충전 메뉴에서 Sandbox 충전금을 충전할 수 있습니다
- Sandbox 충전금을 원하는 금액만큼 충전할 수 있습니다
- Sandbox 충전금과 Live 충전금은 완전히 분리되어 있습니다
가격
Sandbox 환경의 GET /book-specs 응답은 priceBase/pricePerIncrement 대신sandboxPriceBase와 sandboxPricePerIncrement 필드로 판형별 단가를 제공합니다. 표시되는 단가는 운영(Live) 표준 단가와 동일하므로, Sandbox에서 그대로 가격을 확인할 수 있습니다.
계산식 예: sandboxPriceBase=8900, sandboxPricePerIncrement=420, 페이지 26 → 8,900 + (26-24) ÷ 2 × 420 = 9,320원. 값은 상품(BookSpec)에 따라 달라집니다. 월 대량 발주 등 특별 조건의 추가 할인은 Live 환경(priceBase)에 커스텀가로 반영됩니다.
테스트 주문
- 주문 생성 시 Sandbox 충전금이 차감됩니다
- 주문 상태가 결제완료(PAID)에서 멈춥니다 (실제 제작/배송이 진행되지 않음)
- 웹훅 이벤트는 정상적으로 발생합니다
- 주문 전체 취소 · 항목별 부분 취소 모두 테스트할 수 있습니다
Sandbox 환경에서 생성한 책, 주문, 웹훅 설정 등의 데이터는 Live 환경으로 이관되지 않습니다.
Live 환경으로 전환하기
- 사업 협의 — 스위트북과 개별 협의를 진행합니다 (가격, 상품, 운영 조건 등)
- Business 계정 전환 — 협의 완료 후 계정이 Business로 전환됩니다
- Live API Key 발급 — 파트너 포털에서 Live 환경 API Key를 발급합니다
- 실제 충전금 충전 — 파트너 포털에서 결제를 통해 충전금을 충전합니다
- 코드 변경 — Base URL과 API Key만 변경하면 됩니다. API 인터페이스는 동일합니다
Configuration
BASE_URL=https://api-sandbox.sweetbook.com/v1
API_KEY={YOUR_API_KEY}위 탭을 Live로 전환하면 BASE_URL이 운영 도메인으로 자동 치환됩니다. 실제 운영 전환 시에는 API_KEY도 Live 환경에서 발급받은 값으로 교체해야 합니다.