옵션상품(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)
|
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