Coupang Developer Center

API支持的买家用户地区：韩国

该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

优惠券状态

代码	描述
STANDBY	待命
APPLIED	在使用
PAUSED	暂停
EXPIRED	禁用/过期

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）值是否输入正确

[立减优惠券] 查看优惠产品列表 (status)

简介

详细内容

路径

示例

Request Example