기능 소개
강력한 기능으로 빠른 연동을 실현하세요
스위트북 Book Print API가 제공하는 핵심 기능을 확인하고, 여러분의 서비스에 책 제작 기능을 연동해 보세요.
기능 01
템플릿 기반 자동 제작
미리 디자인된 템플릿에 사진과 텍스트 데이터를 전달하면 스위트북 엔진이 자동으로 책을 완성합니다. 복잡한 디자인 작업 없이 데이터만 구성하면 됩니다.
- 일기장, 알림장, 사진앨범, SNS북 등 다양한 카테고리의 템플릿 제공
- JSON 형식으로 사진 URL, 텍스트, 날짜 등을 전달
- 렌더링 완료 시 Webhook으로 즉시 알림 전송
- 미리보기 이미지 URL 자동 생성 제공
기능 02
PDF 직접 업로드
이미 디자인이 완성된 PDF 파일을 업로드하면 바로 책으로 제작할 수 있습니다. 자체 디자인 시스템을 사용하는 파트너사에 최적화된 방식입니다.
- Multipart 업로드 또는 사전 발급 URL(Presigned URL) 방식 지원
- FTP 서버 경로 지정 방식도 지원 (대용량 파일 처리)
- PDF 검증 및 인쇄 규격 자동 확인
- 다양한 판형(A5, A4, 정사각형 등) 지원
기능 03
주문 · 배송 자동화
주문 접수부터 인쇄 제작, 포장, 배송까지 전 과정을 API로 관리하고 추적합니다. 파트너사는 배송지 정보만 전달하면 모든 과정이 자동으로 처리됩니다.
- 주문 접수, 제작 중, 출고, 배송 중, 배송 완료 상태 추적
- 운송장 번호 자동 등록 및 API 조회 가능
- 대량 주문 일괄 처리 지원
- 주문 취소 및 부분 환불 충전금 반환 처리
기능 04
Webhook 실시간 알림
제작 완료, 배송 시작 등 상태 변경 이벤트가 발생할 때마다 파트너 서버로 즉시 HTTP 요청을 전송합니다. 폴링 없이 실시간으로 상태를 파악할 수 있습니다.
- book.rendered, order.shipped, order.delivered 등 이벤트 지원
- HMAC-SHA256 서명 검증으로 보안 보장
- 실패 시 최대 3회 자동 재시도 (1분, 5분, 30분 간격)
- 대시보드에서 Webhook 이력 조회 및 수동 재전송 가능
기능 05
SDK 4종 제공
JavaScript, Python, .NET, Flutter 4가지 언어의 공식 SDK를 제공합니다. 복잡한 HTTP 클라이언트 구현 없이 몇 줄의 코드로 연동을 완료할 수 있습니다.
- JavaScript/TypeScript SDK (npm, Node.js + 브라우저)
- Python SDK (pip, 3.8 이상)
- .NET SDK (NuGet, .NET 6 이상)
- Flutter SDK (pub.dev, Dart 3 이상)