상품
선택한 컨텍스트에서 카탈로그 상품을 조회, 생성, 업데이트, 삭제합니다.
작업
목록 조회 — 상품“상품”의 데이터를 조회합니다. 결과는 이 작업의 매개변수에 따라 달라집니다.
GET
조회 — 상품제품 목록 및 제품 세부정보를 확인하세요.
GET
생성 — 상품카탈로그에 새 제품을 추가합니다.
POST
수정 — 상품기존 제품, 가격, 출판 데이터를 변경합니다.
PATCH
삭제 — 상품과거 거래 데이터를 보존하면서 관리자 패널, 스토어 및 검색에서 상품을 제거합니다.
DELETE
상품 · 파일 추가 · upload_idupload_id를 만든 뒤 multipart/form-data로 파일을 전송하고 상품에 연결합니다. 다운로드에는 Bearer 토큰과 category 권한이 필요하며, 응답에는 공개 주소나 비밀번호 없이 파일 바이트가 포함됩니다. 공유 판매 파일의 명시적 접근 규칙. new_purchases / recent_and_new / selected / all_purchasers.
POST
상품 · 상태 · upload_idupload_id를 만든 뒤 multipart/form-data로 파일을 전송하고 상품에 연결합니다. 다운로드에는 Bearer 토큰과 category 권한이 필요하며, 응답에는 공개 주소나 비밀번호 없이 파일 바이트가 포함됩니다. 공유 판매 파일의 명시적 접근 규칙. new_purchases / recent_and_new / selected / all_purchasers.
GET
상품 · 파일 추가 · multipartupload_id를 만든 뒤 multipart/form-data로 파일을 전송하고 상품에 연결합니다. 다운로드에는 Bearer 토큰과 category 권한이 필요하며, 응답에는 공개 주소나 비밀번호 없이 파일 바이트가 포함됩니다. 공유 판매 파일의 명시적 접근 규칙. new_purchases / recent_and_new / selected / all_purchasers.
PUT
상품 · 상품 파일upload_id를 만든 뒤 multipart/form-data로 파일을 전송하고 상품에 연결합니다. 다운로드에는 Bearer 토큰과 category 권한이 필요하며, 응답에는 공개 주소나 비밀번호 없이 파일 바이트가 포함됩니다. 공유 판매 파일의 명시적 접근 규칙. new_purchases / recent_and_new / selected / all_purchasers.
GET
상품 · 파일 추가 · product_idupload_id를 만든 뒤 multipart/form-data로 파일을 전송하고 상품에 연결합니다. 다운로드에는 Bearer 토큰과 category 권한이 필요하며, 응답에는 공개 주소나 비밀번호 없이 파일 바이트가 포함됩니다. 공유 판매 파일의 명시적 접근 규칙. new_purchases / recent_and_new / selected / all_purchasers.
POST
상품 · 다운로드 · 파일upload_id를 만든 뒤 multipart/form-data로 파일을 전송하고 상품에 연결합니다. 다운로드에는 Bearer 토큰과 category 권한이 필요하며, 응답에는 공개 주소나 비밀번호 없이 파일 바이트가 포함됩니다. 공유 판매 파일의 명시적 접근 규칙. new_purchases / recent_and_new / selected / all_purchasers.
GET
상품 · 헤더upload_id를 만든 뒤 multipart/form-data로 파일을 전송하고 상품에 연결합니다. 다운로드에는 Bearer 토큰과 category 권한이 필요하며, 응답에는 공개 주소나 비밀번호 없이 파일 바이트가 포함됩니다. 공유 판매 파일의 명시적 접근 규칙. new_purchases / recent_and_new / selected / all_purchasers.
HEAD
상품 · 파일 추가 · 버전upload_id를 만든 뒤 multipart/form-data로 파일을 전송하고 상품에 연결합니다. 다운로드에는 Bearer 토큰과 category 권한이 필요하며, 응답에는 공개 주소나 비밀번호 없이 파일 바이트가 포함됩니다. 공유 판매 파일의 명시적 접근 규칙. new_purchases / recent_and_new / selected / all_purchasers.
POST
상품 · 삭제 · 파일upload_id를 만든 뒤 multipart/form-data로 파일을 전송하고 상품에 연결합니다. 다운로드에는 Bearer 토큰과 category 권한이 필요하며, 응답에는 공개 주소나 비밀번호 없이 파일 바이트가 포함됩니다. 공유 판매 파일의 명시적 접근 규칙. new_purchases / recent_and_new / selected / all_purchasers.
DELETE
상품 · 디지털 릴리스upload_id를 만든 뒤 multipart/form-data로 파일을 전송하고 상품에 연결합니다. 다운로드에는 Bearer 토큰과 category 권한이 필요하며, 응답에는 공개 주소나 비밀번호 없이 파일 바이트가 포함됩니다. 공유 판매 파일의 명시적 접근 규칙. new_purchases / recent_and_new / selected / all_purchasers.
GET
상품 · 파일 추가 · 초안이 작업은 종료되었으며 데이터를 변경하지 않고 409를 반환합니다. 각 디지털 파일의 접근은 수신 대상 선택으로 따로 설정하세요.
POST
상품 · 요청 · 초안이 작업은 종료되었으며 데이터를 변경하지 않고 409를 반환합니다. 각 디지털 파일의 접근은 수신 대상 선택으로 따로 설정하세요.
PATCH
상품 · 삭제 · 초안이 작업은 종료되었으며 데이터를 변경하지 않고 409를 반환합니다. 각 디지털 파일의 접근은 수신 대상 선택으로 따로 설정하세요.
DELETE
상품 · 릴리스 게시이 작업은 종료되었으며 데이터를 변경하지 않고 409를 반환합니다. 각 디지털 파일의 접근은 수신 대상 선택으로 따로 설정하세요.
POST
상품 · 판매 중단이 작업은 종료되었으며 데이터를 변경하지 않고 409를 반환합니다. 각 디지털 파일의 접근은 수신 대상 선택으로 따로 설정하세요.
POST
상품 · 구매 후 추가되는 파일에 대한 접근 권한이 작업은 종료되었으며 데이터를 변경하지 않고 409를 반환합니다. 각 디지털 파일의 접근은 수신 대상 선택으로 따로 설정하세요.
PATCH
파일 수신 대상 조회접근 규칙과 상품 버전을 조회하세요. 최초 게시 시점은 기준으로 유지됩니다.
GET
파일 수신 대상 선택자격이 있는 구매를 선택하세요. 선택한 주문에는 결제되었으며 환불되지 않은 이 상품이 있어야 합니다.
PATCH
작동 방식
연동은 초안을 포함해 삭제되지 않은 모든 상품을 읽을 수 있지만 요금제 한도로 차단된 상품은 제외됩니다. 차단된 상품은 목록에 나타나지 않고 직접 접근하면 entitlements.resource_blocked 를 반환합니다. 따라서 API의 상품 가시성은 스토어 공개 상태와 다릅니다.
브랜드, 카테고리, 속성, 미디어는 기존 식별자를 사용하세요. 가격에는 통화, 가격표, 세금 모드, 동시성 제어 버전이 명시됩니다. 상품 가격과 옵션 상품 가격은 별개입니다. 지원하는 가격 구조와 정확한 십진수 문자열을 사용하세요.
상품 파일
upload_id를 만든 뒤 multipart/form-data로 파일을 전송하고 상품에 연결합니다. 다운로드에는 Bearer 토큰과 category 권한이 필요하며, 응답에는 공개 주소나 비밀번호 없이 파일 바이트가 포함됩니다. 공유 판매 파일의 명시적 접근 규칙. new_purchases / recent_and_new / selected / all_purchasers.
올바른 PDF, ZIP, EPUB, MP3 또는 MP4, WebP, PNG, JPG, SVG, AVIF 파일을 선택하세요. 파일당 최대 250 MiB. 상품당 활성 파일은 최대 20개입니다.