Book Print API 개요
Book Print 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를 발급받아 요청 헤더에 포함하세요. 자세한 내용은 인증 가이드를 참조하세요.
Request
curl -X GET 'https://api-sandbox.sweetbook.com/v1/books' \
-H "Authorization: Bearer {YOUR_API_KEY}"표준 응답 형식
모든 API는 다음과 같은 표준 응답 형식을 사용합니다.
성공 응답
성공 응답에서는
errors 필드가 JSON에 포함되지 않습니다.Response
{
"success": true,
"message": "Success",
"data": { ... }
}실패 응답
요청이 실패하면 success가 false이며, errors 배열에 상세 오류 메시지가 포함됩니다.
Error response
{
"success": false,
"message": "Error message",
"data": null,
"errors": ["세부 에러 메시지들"]
}시작하기
처음 연동을 시작하시는 경우 아래 순서대로 진행하세요. 각 API 레퍼런스는 좌측 사이드바에서 확인할 수 있습니다.
파트너 등록
가입하고 Sandbox API Key를 발급받으세요.
자세히 보기 →인증 (API Key)
발급받은 API Key로 요청을 인증하는 방법을 확인하세요.
자세히 보기 →창작 방식 선택
PDF 업로드 / 템플릿 / 혼합 중 적합한 방식을 결정하세요.
자세히 보기 →전체 워크플로우
책 생성부터 주문·배송까지 전체 흐름을 따라가세요.
자세히 보기 →환경 (Sandbox / Live)
Sandbox와 Live 환경 차이와 도메인 분리 방식을 알아보세요.
자세히 보기 →SDKs & Demo Apps
Python · Node.js SDK와 실행 가능한 데모 웹앱으로 빠르게 시작하세요.
자세히 보기 →