GET
/v2/providers/marketplace_openapi/apis/api/v1/coupons/{couponId}2609170000[可下载优惠券]单个优惠券查询（couponId)
# 01
简介
[可下载优惠券]单个优惠券查询（couponId)
# 02
详细内容
API支持的买家用户地区：韩国
使用couponId(创建优惠券时通过Response确认)查询下载优惠券。
路径
GET/v2/providers/marketplace_openapi/apis/api/v1/coupons/{couponId}
示例端点
https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/coupons/11234224# 03
Path 参数
| Name | Type | Description |
|---|---|---|
| couponId* | number | 下载优惠券ID (创建优惠券时通过Response确认) |
# 04
响应体
响应消息
| Name | Type | Description | ||||||
|---|---|---|---|---|---|---|---|---|
| couponId | integer | 优惠券ID 创建优惠券商品/删除&查询优惠券时使用 | ||||||
| title | string | 优惠券名称 优惠券下载页面名称 | ||||||
| couponType | string | 优惠券类型
| ||||||
| couponStatus | string | 优惠券状态 创建时显示为“STANDBY” | ||||||
| publishedDate | string | 优惠券发行日 (优惠券商品的初始时间) | ||||||
| startDate | string | 优惠券开始时间 'YYYY-MM-DD HH:MM:SS' | ||||||
| endDate | string | 优惠券结束日期 'YYYY-MM-DD HH:MM:SS' | ||||||
| appliedOptionCount | integer | 使用优惠券的vendorId数量
| ||||||
| usageAmount | integer | 优惠券使用量
| ||||||
| couponPolicies | object[] | 优惠券ID(Wing优惠券编号)
| ||||||
| title couponPolicies[].title | string | 优惠券政策名称 该名称是在购物车中选择优惠券时显示的名称，与优惠券名称不同 | ||||||
| typeOfDiscount couponPolicies[].typeOfDiscount | string | 优惠券政策类型
| ||||||
| CODE couponPolicies[].CODE | string | |||||||
| RATE | string | 固定比率
| ||||||
RATE. | object | |||||||
RATE.. | object | |||||||
RATE... | object | |||||||
| PRICE RATE....PRICE | string | |||||||
| description RATE.description | string | 优惠券详细说明 购物车中优惠券政策名称的补充说明 | ||||||
| minimumPrice RATE.minimumPrice | number | 使用优惠券的最低购买金额 为使用优惠券必须达到的订单金额 | ||||||
| discount RATE.discount | number | 优惠券折扣金额或比率(%)
| ||||||
| maximumDiscountPrice RATE.maximumDiscountPrice | number | 最高折扣金额 typeOfDiscount 为RATE 时有效 为PRICE时，显示为-1 | ||||||
| maximumPerDaily RATE.maximumPerDaily | number | 最多发行数量 (1人/1天) 不可超过9,999 |
Response Example
{
"couponId": 11234224,
"title": "쿠폰 명칭",
"couponType": "DOWNLOAD",
"couponStatus": "STANDBY",
"publishedDate": "",
"startDate": "2019-05-24 19:55:00",
"endDate": "2019-06-08 11:00:00",
"appliedOptionCount": 0,
"usageAmount": 0,
"couponPolicies": [
{
"title": "해당쿠폰의 정책 1 명칭",
"typeOfDiscount": "RATE",
"description": "해당정책 안내 문구 작성1",
"minimumPrice": 1000,
"discount": 10,
"maximumDiscountPrice": 2000,
"maximumPerDay": 999
},
{
"title": "해당쿠폰의 정책 2 명칭",
"typeOfDiscount": "RATE",
"description": "해당정책 안내 문구 작성2",
"minimumPrice": 2000,
"discount": 20,
"maximumDiscountPrice": 3000,
"maximumPerDay": 999
},
{
"title": "해당쿠폰의 정책 3 명칭",
"typeOfDiscount": "RATE",
"description": "해당정책 안내 문구 작성3",
"minimumPrice": 3000,
"discount": 30,
"maximumDiscountPrice": 3400,
"maximumPerDay": 999
}
]
}# 05
错误码
| HTTP | 代码 | 消息 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
错误说明
| HTTP | 类型 | 错误消息 | 解决方案 |
|---|---|---|---|
| 400 | 400 (确认请求参数) | 该促销不存在(228047***)。 | 请确认您输入的优惠券ID(couponId)值是否正确。 |