파트너 등록 가이드
가입부터 Sandbox API Key 발급까지의 절차를 안내합니다. 5분이면 완료할 수 있습니다.
전체 흐름
1. 가입→2. 이메일 인증→3. 로그인→4. API Key 발급→5. 첫 API 호출
Step 1. 회원가입
- 파트너 포털 가입 페이지에 접속합니다
- 이메일 주소를 입력하고 인증번호 발송을 클릭합니다
- 이메일로 수신된 인증번호를 입력합니다
- 비밀번호를 설정하고 가입을 완료합니다
가입 즉시 Personal 계정이 생성되며, Sandbox 환경을 사용할 수 있습니다. Live 환경은 스위트북과 사업 협의 후 사용 가능합니다.
Step 2. 파트너 포털 로그인
- 파트너 포털 로그인 페이지에서 가입한 이메일과 비밀번호로 로그인합니다
- 로그인 후 파트너 대시보드가 표시됩니다
Step 3. Sandbox API Key 발급
- 파트너 포털 > 설정 > API Key를 클릭합니다
- 새 API Key 발급 버튼을 클릭합니다
- 환경에서 Sandbox를 선택합니다
- 메모(선택)를 입력하고 발급합니다
- 발급된 API Key를 복사하여 안전한 곳에 저장합니다
API Key는 발급 시에만 전체 값을 확인할 수 있습니다. 이후에는 접두사(prefix)만 표시됩니다. 발급 즉시 안전한 곳에 저장하세요.
- 모든 API Key는
SB접두사로 시작합니다 - 접두사와 시크릿은
.으로 구분됩니다 - 발급 개수 제한이 없으며, 필요 시 폐기 후 재발급 가능합니다
- 만료 기간 없이 폐기하지 않는 한 계속 유효합니다
API Key format
SB{12자리 prefix}.{시크릿}
예시: SB9A1X36H2YZ.a1b2c3d4e5f6g7h8i9j0...Step 4. 첫 API 호출 테스트
발급받은 Sandbox API Key로 상품 목록을 조회해보세요.
응답이 정상적으로 돌아왔다면 연동 준비가 완료된 것입니다.
인증 실패 시
| 에러 | 원인 | 해결 |
|---|---|---|
401 Unauthorized | API Key가 잘못되었거나, Sandbox Key로 Live URL에 요청 | API Key 확인, Base URL이 api-sandbox인지 확인 |
403 Forbidden | 폐기된 API Key 사용, 또는 IP 제한에 걸림 | 파트너 포털에서 API Key 상태 확인 |
Request
curl -X GET 'https://api-sandbox.sweetbook.com/v1/book-specs' \
-H "Authorization: Bearer {YOUR_API_KEY}"Response
{
"success": true,
"message": "Success",
"data": [
{
"bookSpecUid": "PHOTOBOOK_A4_SC",
"name": "A4 소프트커버 포토북",
"pageMin": 24,
"pageMax": 130,
...
}
]
}Sandbox 충전금
- 파트너 포털 > 충전금 > 충전 메뉴에서 원하는 금액을 충전할 수 있습니다
- Sandbox 주문 시 테스트 가격(100원 이하)이 적용됩니다
- Sandbox 충전금과 Live 충전금은 완전히 분리되어 있습니다