该API用于按照订单号码状态查看创建的优惠券列表。
路径
GET
/v2/providers/fms/apis/api/v2/vendors/{vendorId}/{orderId}/coupons
示例
https://api-gateway.coupang.com/v2/providers/fms/apis/api/v2/vendors/A00012345/8000000000294/coupons
请求参数
Name | Required | Type | Description | ||||
---|---|---|---|---|---|---|---|
vendorId | O | String |
卖家ID 酷澎分配给卖家的固有代码 ex) A00012345 |
||||
orderId | O | Number |
订单号码
|
请求体
无
返回消息
名称 | 数据类型 | 描述 | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
code | Number |
服务器响应代码
|
||||||||||||||||
message | String |
服务器响应信息
|
||||||||||||||||
httpStatus | Number |
HTTP状态代码 (与服务器响应代码的值相同)
|
||||||||||||||||
httpStatusMessage | String |
HTTP 状态信息 (与服务器响应信息的值相同)
|
||||||||||||||||
errorMessage | String |
除HTTP Status 200以外,剩下Status 中包含服务器详细失败原因信息。
|
||||||||||||||||
data | Object |
优惠券列表数据
|
||||||||||||||||
success | Boolean |
成功与否 true or false |
||||||||||||||||
content | Array |
优惠券列表
|
||||||||||||||||
contractId | Number |
卖家合同号码
ex) 1, 2
|
||||||||||||||||
couponId | Number |
优惠券号码
ex) 75, 80
|
||||||||||||||||
discount | Number |
折扣
ex) 100.0, 20.0
|
||||||||||||||||
endAt | String |
有效期结束时间 日期/时间
ex) 2017-09-01 00:00:00
|
||||||||||||||||
maxDiscountPrice | Number |
最大优惠金额
ex) 1000, 10000
|
||||||||||||||||
promotionName | String |
促销名称
ex) Dress discount coupon for the 2nd wk of Jan
|
||||||||||||||||
startAt | String |
有效期开始时间 日期/时间
ex) 2017-08-04 01:00:00
|
||||||||||||||||
status | String |
优惠券状态
|
||||||||||||||||
type | String |
折扣类型
ex) RATE (固定比例折扣), FIXED_WITH_QUANTITY (满足订单产品数量的折扣) and PRICE (固定金额折扣)
|
||||||||||||||||
wowExclusive | Boolean |
折扣受众
false (全部买家: 默认)
true (火箭会员用户)
|
||||||||||||||||
vendorItemId | Number |
产品单项号码
ex) 3223826213
|
||||||||||||||||
Pagination | null |
使用订单号码查询没有分页
|
返回消息示例
{
"code": 200,
"message": "OK",
"httpStatus": 200,
"httpStatusMessage": "OK",
"errorMessage": "",
"data": {
"success": true,
"content": [
{
"vendorItemId": 5500016112,
"contractId": 10,
"promotionName": "99%",
"couponId": 91,
"status": "PAUSED",
"type": "RATE",
"maxDiscountPrice": 1000000,
"discount": 99,
"startAt": "2017-11-22 00:00:00",
"endAt": "2017-11-23 23:59:00",
"wowExclusive": "false"
},
{
"vendorItemId": 53000439458,
"contractId": 7,
"promotionName": "자유계약 원피스 폭탄 세일 시즌 1",
"couponId": 65,
"status": "PAUSED",
"type": "RATE",
"maxDiscountPrice": 1000,
"discount": 10,
"startAt": "2017-09-22 00:00:00",
"endAt": "2017-09-23 23:59:00",
"wowExclusive": "false"
}
],
"pagination": null
}
}
错误信息
HTTP status code (error type) |
Error message |
How to resolve |
400 (check request parameter) |
请确认卖家权限 |
查看卖家ID(vendorid)值是否输入正确 |