该API用于将创建的优惠券添加至单件商品。本API是异步的方式,仅执行处理请求。
可使用响应的“requestedId”值,通过确认请求状态API来查看实际API 执行结果值。
请在添加产品到立减优惠券的时候谨慎选择产品列表,因为此立减优惠券创建之后卖家就无法对优惠券的产品列表进行删除操作。如果您确实需要删除其中的一些产品,请暂停旧的优惠券,创建新的立减优惠券,并添加新的产品列表。
路径
POST
/v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items
示例
https://api-gateway.coupang.com/v2/providers/fms/apis/api/v1/vendors/A00012345/coupons/68/items
请求参数
Name |
Required |
Type |
Description |
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
couponId |
O |
Number |
要使用的优惠券ID |
请求体参数
Name |
Required |
Type |
Description |
vendorItems |
O |
Array |
要添加优惠券的属性ID 一次最多可添加10,000件属性ID |
请求体示例
{
"vendorItems": [
3226138951,
3226138847
]
}
返回消息
Name | Type | Description | ||||
---|---|---|---|---|---|---|
code | Number |
服务器返回码
|
||||
message | String |
服务器返回消息
|
||||
httpStatus | Number |
HTTP 状态码(与服务器返回码相同)
|
||||
httpStatusMessage | String |
HTTP 状态消息(与服务器返回消息相同)
|
||||
errorMessage | String |
错误详情,HTTP 状态码为 200 时,无错误信息
|
||||
data | Object |
请求成功与否的数据
|
||||
success | Boolean |
真或假
|
||||
content | Object |
可查看处理状态的请求ID数据
|
||||
requestedId | String |
查看处理状态的请求ID
e.g. 1542675975663862164
|
||||
success | Boolean |
真或假
|
||||
Pagination | Array |
无分页
|
返回消息示例
{
"code": 200,
"message": "OK",
"httpStatus": 200,
"httpStatusMessage": "OK",
"errorMessage": "",
"data": {
"success": true,
"content": {
"requestedId": "17258005702255081464",
"success": true
},
"pagination": null
}
}
错误信息
HTTP Status Code (Error Code) |
Error Message |
Solution |
400 (check parameter requested) |
vendorItems可能不为空,数量必须要1和10000之间。 |
查看要添加优惠券的属性ID(vendoritems)是否输入正确。 一次最多添加10,000件属性ID。 |
400 (check parameter requested) |
请确认卖家权限。 |
查看卖家ID(vendorid)值是否输入正确。 |
400 (check parameter requested) |
请确认优惠券ID 208463**** |
查看优惠券ID(couponid)值是否输入正确。 |