Skip to main content
POST
cURL
지원 종료. 이 v2 엔드포인트는 2026년 10월 9일 09:00 KST(00:00 UTC)에 지원이 종료되었습니다. 새로 연동한다면 POST /api/v3/orders/wtr-embed를 사용하고, 마이그레이션 방법은 워터마크 삽입 빠른 시작을 참고하세요.v2 지원 종료 후 동작 (2026년 10월 9일 09:00 KST, 00:00 UTC부터):
  • 인증·권한 검사는 지금처럼 먼저 수행하므로 401, 403 오류는 기존과 같습니다.
  • 인증을 통과한 v2 워터마크 삽입·검출 요청은 live 키와 sk_test_ 키 모두 410 Gone과 { "code": "WATERMARK_V2_API_SUNSET" }을 받습니다. Link 헤더가 v3 엔드포인트를 가리키니 v3로 새로 요청하세요.
  • 그때까지 처리를 시작하지 않은 v2 주문은 처리되지 않고 실패로 확정됩니다. 주문 상세(errors.errorCode)와 실패 웹훅에 WATERMARK_V2_API_SUNSET과 v3 안내 메시지가 담기며, 과금되지 않고 크레딧은 복원됩니다.
  • 종료 시각에 이미 처리 중인 주문은 결과 기록까지 마칩니다. 이후 새로 다시 실행하지는 않습니다.
  • 기존 v2 주문 조회와 이미 생성된 결과·보고서 다운로드는 기존 보존 기간 안에서 계속 이용할 수 있습니다. v2 보고서를 새로 생성하거나 재생성할 수는 없습니다.
그 전까지 요청·응답 동작은 같고, v2 워터마크 엔드포인트의 모든 응답에 Deprecation: true, Sunset: Fri, 09 Oct 2026 00:00:00 GMT, Link 헤더만 추가됩니다.
v3 워터마크 검출은 v2로 삽입한 워터마크를 검출할 수 없습니다. 엔드포인트만 v3로 바꿔도 기존 v2 워터마크 이미지는 검출되지 않으며, v2 지원이 종료된 뒤 v2 검출을 위한 예외도 제공하지 않습니다.

지원 종료 후 응답

2026년 10월 9일 09:00 KST(00:00 UTC)부터 이 엔드포인트에 인증을 통과한 요청을 보내면 다음과 같이 응답합니다.
Link 헤더의 v3 엔드포인트로 새로 요청하세요.
sk_test_ 키를 사용하면 응답의 BIZ MORI 테스트 업로드 URL로 파일을 업로드합니다. 업로드가 끝나면 confirm 없이 처리가 시작되며 다운로드 가능한 결과 파일은 만들지 않습니다.

주문 결과 다운로드

주문이 complete 상태가 되면 주문 결과 다운로드 URL 발급을 호출하세요. 한 번의 호출로 결과 파일별 URL(files[])과 결과 전체 ZIP(archiveUrl)을 함께 받습니다.
URL은 최대 1시간 동안 유효하므로 다운로드할 때마다 새로 요청하세요. 파일은 주문의 expiresAt까지 내려받을 수 있으며, 그 뒤에는 400 ORDER_EXPIRED를 반환합니다. sk_test_ 주문의 URL은 실제 결과가 아니라 고정 샘플 파일을 가리킵니다.

인증

Authorization
string
header
필수

외부 클라이언트 접근을 위한 Bearer API 키. 일반 키는 sk_ 접두사를 사용하고, 테스트 키는 sk_test_ 접두사로 모의 응답을 사용해 실제 처리나 크레딧 사용 없이 주문 흐름을 검증합니다.

본문

application/json
idempotencyKey
string
필수

멱등성 키

files
object[]
필수
Required array length: 1 - 100 elements

응답

주문 생성 성공

data
object