使用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
请求参数
|
Name |
Required |
Type |
Description |
|
couponId |
O |
Number |
下载优惠券ID (创建优惠券时通过Response确认) |
请求体
无
返回消息
|
Name |
Type |
Description |
||||||||||
|
couponId |
Number |
优惠券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 |
Number |
使用优惠券的vendorId数量 |
||||||||||
|
usageAmount |
Number |
优惠券使用量 |
||||||||||
|
couponPolicies |
Number |
优惠券ID(Wing优惠券编号) |
||||||||||
|
|
title |
String |
优惠券政策名称 该名称是在购物车中选择优惠券时显示的名称，与优惠券名称不同 |
|||||||||
|
|
typeOfDiscount |
String |
优惠券政策类型 |
|||||||||
|
|
CODE |
MEANING |
|
|||||||||
|
RATE |
固定比率 |
|||||||||||
|
|
|
|
|
PRICE |
满减折扣 |
|
||||||
|
|
||||||||||||
|
|
description |
String |
优惠券详细说明 购物车中优惠券政策名称的补充说明 |
|||||||||
|
|
minimumPrice |
Number |
使用优惠券的最低购买金额 为使用优惠券必须达到的订单金额 |
|||||||||
|
|
discount |
Number |
优惠券折扣金额或比率(%)
|
|||||||||
|
|
maximumDiscountPrice |
Number |
最高折扣金额 typeOfDiscount 为RATE 时有效 为PRICE时，显示为-1 |
|||||||||
|
|
maximumPerDaily |
Number |
最多发行数量 (1人/1天) 不可超过9,999 |
|||||||||
返回消息示例
{
"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
}
]
}错误信息
|
HTTP状态代码（错误类型） |
错误信息 |
解决方案 |
|
400 (确认请求参数) |
该促销不存在(228047***)。 |
请确认您输入的优惠券ID(couponId)值是否正确。 |
接口名称
GET_COUPON_BY_ID