환경 (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)를 null로 숨기고, 별도의 sandboxPriceBase와 sandboxPricePerIncrement 필드로 테스트 가격을 제공합니다.
예: sandboxPriceBase=100, sandboxPricePerIncrement=10, 페이지 26 → 기본 가격 100 + (26-24) × 10 = 120원. 값은 상품(BookSpec)에 따라 달라질 수 있습니다.
테스트 주문
- 주문 생성 시 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 환경에서 발급받은 값으로 교체해야 합니다.