该API用于按照优惠券状态查看创建的优惠券中的产品单项。
路径
GET
/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/99/items?status=APPLIED&page=1&size=10&sort=desc
请求参数
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
卖家ID 酷澎分配给卖家的固有代码 ex) A00012345 |
||||
| couponId | O | Number |
Coupon 号
|
||||
链接请求参数
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| status | O | String |
优惠券状态(STANDBY, APPLIED, PAUSED 和 EXPIRED)
|
||||
| page | Number |
页码: 默认为 0
输入数字来查看下一页; 不输入或者输入 '0' 来查看第一页，输入 '1' 来查看第二页，以此类推
|
|||||
| size | Number |
每个页面所包含的产品数目
|
|||||
| sort | String |
排序 (asc, desc)
默认升序
|
|||||
Request Example
not require body
返回参数
| 名称 | 数据类型 | 描述 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
优惠券内容列表
|
||||||||||||||
| couponItemId | Number |
优惠券单项号码
ex) 80984
|
||||||||||||||
| couponId | Number |
优惠券号码
ex) 75, 80
|
||||||||||||||
| vendorItemId | Number |
产品单项号码
ex) 3223826213
|
||||||||||||||
| startAt | String |
有效期开始时间 日期/时间
ex) 2017-08-04 01:00:00
|
||||||||||||||
| endAt | String |
有效期结束时间 日期/时间
ex) 2017-09-01 00:00:00
|
||||||||||||||
| status | String |
优惠券状态
|
||||||||||||||
| Pagination | Array |
分页
|
||||||||||||||
| countPerPage | Number |
每页数据量
ex) 10, 20, 30
|
||||||||||||||
| currentPage | Number |
当前页
ex) 1
|
||||||||||||||
| totalPages | Number |
总页面数
ex) 1000
|
||||||||||||||
| totalElements | Number |
总数据量
ex) 1000
|
||||||||||||||
返回消息示例
{
"code": 200,
"message": "OK",
"httpStatus": 200,
"httpStatusMessage": "OK",
"errorMessage": "",
"data": {
"success": true,
"content": [
{
"couponItemId": 81172,
"couponId": 84,
"vendorItemId": 3226138951,
"startAt": "2017-08-09 01:00:00",
"endAt": "2017-09-01 00:00:00",
"status": "APPLIED"
},
{
"couponItemId": 81171,
"couponId": 84,
"vendorItemId": 3226138847,
"startAt": "2017-08-09 01:00:00",
"endAt": "2017-09-01 00:00:00",
"status": "APPLIED"
}
],
"pagination": {
"currentPage": 0,
"countPerPage": 1000,
"totalPages": 1,
"totalElements": 2
}
}
}错误信息
|
HTTP status code (error type) |
Error message |
How to resolve |
|
400 (check request parameter) |
请确认卖家权限 |
查看卖家ID（vendorid）值是否输入正确 |