[可下载优惠券]单个优惠券查询（couponId)

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

请求参数

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	优惠券折扣金额或比率(%)  CODE  Example  RATE  1~99整数输入  PRICE  以10韩元为单位
	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