API 적용 가능한 구매자 사용자 지역: 한국
옵션상품(vendorItemId)에 생성된 다운로드 쿠폰을 적용하기 위한 API입니다.
상품 추가에 실패하면 해당 쿠폰은 파기됩니다.
Path
PUT/v2/providers/marketplace_openapi/apis/api/v1/coupon-items
Example Endpoint
https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/coupon-itemsRequest Parameters
Body Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| couponItems | O | Array |
상품 쿠폰적용을 위한 데이터
|
||||
| couponId | Number |
쿠폰ID
쿠폰생성 Response에서 확인 가능
|
|||||
| userId | String |
사용자 계정 (WING 로그인 ID)
|
|||||
| vendorItemIds | Array |
쿠폰 적용하고자 하는 옵션ID(s)
한 번에 적용할 옵션ID 수는 100개를 초과할 수 없음
|
|||||
Request Example
{
"couponItems": [
{
"couponId": "15350660",
"userId": "testaccount1",
"vendorItemIds": [
2306264997,
4802314648,
4230264914
]
}
]
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| requestResultStatus | String |
호출 결과
SUCCESS / FAIL
|
||||
| body | Object |
|
||||
| couponId | Integer |
해당 쿠폰 ID
|
||||
| errorCode | String |
에러발생 시 분류
|
||||
| errorMessage | String |
에러 상세내용
|
||||
Response Example
{
"requestResultStatus": "SUCCESS",
"body": {
"couponId": 15350660
},
"errorCode": null,
"errorMessage": null
}Error Spec
| HTTP 상태 코드 (오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | 삭제된 프로모션 입니다. | 쿠폰ID(couponId) 값을 올바로 입력했는지 확인합니다. 옵션에 쿠폰 적용이 실패하여 쿠폰ID가 삭제되었는지 확인합니다. |
URL API Name
Add_VENDOR_ITEMS_TO_COUPON