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