SweetBook API 개요
SweetBook API를 사용하면 포토북 생성부터 주문, 배송까지 전 과정을 자동화할 수 있습니다.
파트너 여정:가입→Sandbox 테스트→사업 협의→가격 결정→Live 운영
기본 정보
| Base URL (Live) | https://api.sweetbook.com/v1 |
| Base URL (Sandbox) | https://api-sandbox.sweetbook.com/v1 |
| API 버전 | v1 |
| 응답 형식 | JSON |
| 인증 | API Key (Bearer Token) |
모든 API 요청에는 API Key가 필요합니다. 파트너 포털에서 API Key를 발급받아 요청 헤더에 포함하세요. 자세한 내용은 인증 가이드를 참조하세요.
bash
curl -X GET 'https://api.sweetbook.com/v1/books' \
-H "Authorization: Bearer {YOUR_API_KEY}"표준 응답 형식
모든 API는 다음과 같은 표준 응답 형식을 사용합니다.
성공 응답
json
{
"success": true,
"message": "Success",
"data": { ... }
}실패 응답
json
{
"success": false,
"message": "Error message",
"data": null,
"errors": ["세부 에러 메시지들"]
}성공 응답에서는
errors 필드가 JSON에 포함되지 않습니다.주요 엔드포인트
Books (책 관리)
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
POST | /books | 책 생성 |
GET | /books | 책 목록 조회 |
POST | /books/{bookUid}/cover | 표지 추가 |
POST | /books/{bookUid}/contents | 콘텐츠 추가 |
POST | /books/{bookUid}/finalization | 책 최종화 |
Orders (주문 관리)
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
POST | /orders | 주문 생성 |
POST | /orders/estimate | 가격 조회 |
GET | /orders | 주문 목록 조회 |
GET | /orders/{orderUid} | 주문 상세 조회 |
POST | /orders/{orderUid}/cancel | 주문 취소 |
Templates (템플릿)
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
GET | /templates | 템플릿 목록 조회 |
GET | /templates/{templateUid} | 템플릿 상세 조회 |
GET | /template-categories | 템플릿 카테고리 목록 조회 |
BookSpecs (상품 스펙)
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
GET | /book-specs | 상품 스펙 목록 조회 |
GET | /book-specs/{bookSpecUid} | 상품 스펙 상세 조회 |
Webhooks (웹훅)
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
PUT | /webhooks/config | 웹훅 등록/수정 |
POST | /webhooks/test | 테스트 이벤트 전송 |
시작하기
파트너 등록
가입하고 Sandbox API Key를 발급받으세요.
환경 이해하기
Sandbox와 Live 환경의 차이를 알아보세요.
빠른 시작 가이드
Sandbox에서 첫 포토북을 만들어 보세요.
인증 (API Key)
API Key 인증 방식을 자세히 알아보세요.
Books API
책 생성, 표지/내지 추가, 최종화 API를 확인하세요.
Orders API
주문 생성, 가격 조회, 상태 관리 API를 확인하세요.
Templates 활용 가이드
템플릿 종류와 책에 적용하는 방법을 알아보세요.
BookSpecs 가이드
판형 종류와 선택 기준을 확인하세요.
Webhooks 연동 가이드
웹훅 설정과 이벤트 수신 서버 구현 방법을 알아보세요.