환경 이해하기
SweetBook API는 Sandbox와 Live 두 가지 환경을 제공합니다. 각 환경은 완전히 분리되어 있으며, API Key와 Base URL이 다릅니다.
API Base URL
Sandbox와 Live의 Base URL이 다릅니다. Sandbox API Key로 Live URL에 요청하면 인증 오류(401)가 발생합니다. 반드시 환경에 맞는 URL을 사용하세요.
| 환경 | Base URL |
|---|---|
| Sandbox | https://api-sandbox.sweetbook.com/v1 |
| Live | https://api.sweetbook.com/v1 |
서버는 요청 도메인을 기반으로 환경을 자동 판별합니다. 별도의 환경 파라미터가 필요하지 않습니다.
bash
# Sandbox 환경
curl -X GET 'https://api-sandbox.sweetbook.com/v1/book-specs' \
-H "Authorization: Bearer {SANDBOX_API_KEY}"
# Live 환경
curl -X GET 'https://api.sweetbook.com/v1/book-specs' \
-H "Authorization: Bearer {LIVE_API_KEY}"환경별 차이
| 항목 | Sandbox | Live |
|---|---|---|
| Base URL | api-sandbox.sweetbook.com | api.sweetbook.com |
| API Key | Sandbox 전용 키 | Live 전용 키 |
| 충전금 | 테스트 충전금 (파트너 포털에서 직접 입력/조절) | 실제 충전금 (결제로 충전) |
| 가격 | 테스트 가격 (100원 이하) | 협의된 실제 가격 |
| 실제 인쇄 | 하지 않음 | 실제 인쇄 진행 |
| 실제 배송 | 하지 않음 | 한진택배 배송 (3~4영업일 출고) |
| 웹훅 | 발생함 | 발생함 |
| 주문 상태 | 결제완료(PAID)에서 멈춤 | 전체 흐름 진행 |
| 데이터 | Sandbox 전용 (Live와 완전 분리) | Live 전용 |
계정 타입별 환경 접근
가입 시 Personal 계정이 생성되며, 사업 협의 완료 후 Business 계정으로 전환됩니다.
| 계정 타입 | Sandbox | Live | 전환 조건 |
|---|---|---|---|
| Personal | 사용 가능 | 사용 불가 | 가입 즉시 |
| Business | 사용 가능 | 사용 가능 | 스위트북과 사업 협의 완료 후 |
Sandbox 환경 상세
테스트 충전금
- 파트너 포털의 충전금 관리 메뉴에서 원하는 금액을 직접 입력하여 테스트 충전금을 설정할 수 있습니다
- 파트너 포털에서 테스트 충전금을 자유롭게 추가/삭제할 수 있습니다 (실제 금액이 아닙니다)
- 테스트 충전금과 실제 충전금은 완전히 분리되어 있습니다
테스트 주문
- 주문 생성 시 테스트 충전금이 차감됩니다
- 테스트 가격이 적용됩니다 (100원 이하)
- 주문 상태가 결제완료(PAID)에서 멈춥니다 (실제 제작/배송이 진행되지 않음)
- 웹훅 이벤트는 정상적으로 발생합니다
- 주문 취소 테스트도 가능합니다
Sandbox 환경에서 생성한 책, 주문, 웹훅 설정 등의 데이터는 Live 환경으로 이관되지 않습니다. 각 환경의 데이터는 완전히 독립적입니다.
Live 환경으로 전환하기
Sandbox에서 충분히 테스트한 후, 다음 절차를 통해 Live 환경을 사용할 수 있습니다.
- 사업 협의 — 스위트북과 개별 협의를 진행합니다 (가격, 상품, 운영 조건 등)
- Business 계정 전환 — 협의 완료 후 계정이 Business로 전환됩니다
- Live API Key 발급 — 파트너 포털에서 Live 환경 API Key를 발급합니다
- 실제 충전금 충전 — 파트너 포털에서 결제를 통해 충전금을 충전합니다
- 코드 변경 — Base URL과 API Key만 변경하면 됩니다. API 인터페이스는 동일합니다
diff
# 변경 전 (Sandbox)
- BASE_URL=https://api-sandbox.sweetbook.com/v1
- API_KEY=SBxxxx.sandbox_key
# 변경 후 (Live)
+ BASE_URL=https://api.sweetbook.com/v1
+ API_KEY=SBxxxx.live_key