coupang
GET/v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items/{couponItemId}v1

[立减优惠券] 查看单个优惠券 (couponItemId)

# 01

简介

API支持的买家用户地区:韩国 该API用于 通过优惠券单品I D 查看使用了优惠券的单品。

# 02

详细内容

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

该API用于通过优惠券单品ID查看使用了优惠券的单品。 

路径

GET

/v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items/{couponItemId}

示例

https://api-gateway.coupang.com/v2/providers/fms/apis/api/v1/vendors/A00012345/coupons/77/items/80984?type=couponItemId

请求参数

Name 

 

Required 

Type 

Description 

vendorId 

O 

 

String 

卖家ID 

酷澎分配给卖家的固有代 

ex) A00012345 

couponId 

O 

 

Number 

优惠券ID 

couponItemId 

O 

 

Number 

优惠券单品ID 

链接请求参数

Name 

Required 

 Type

Description 

type 

O 

String 

couponItemId 

请求体

返回消息

Name 

Type 

Description 

code 

Number 

响应代码 

message 

String 

响应信息 

httpStatus 

Number 

HTTP状态代码 (与服务器响应代码的值相同) 

httpStatusMessage 

String 

HTTP 状态信息 (与服务器响应信息的值相同) 

errorMessage 

String 

除HTTP Status 200以外,剩下Status 中包含服务器详细失败原因信息 

data 

Object 

优惠券单品信息列表数据 

  

success 

Boolean 

成功与否 

true or false 

  

content 

Object 

优惠券单品列表 

  

  

couponItemId 

Number 

优惠券单品ID  

ex) 80984 

  

  

couponId 

Number 

优惠券ID  

ex) 75, 80 

  

  

vendorItemId 

Number 

属性ID 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 

单件优惠券查看,因此无分页 

返回消息示例

{
  "code": 200,
  "message": "OK",
  "httpStatus": 200,
  "httpStatusMessage": "OK",
  "errorMessage": "",
  "data": {
    "success": true,
    "content": {
      "couponItemId": 80984,
      "couponId": 77,
      "vendorItemId": 3223826213,
      "startAt": "2017-08-04 01:00:00",
      "endAt": "2017-09-01 00:00:00",
      "status": "APPLIED"
    },
    "pagination": null
  }
}

错误信息

HTTP status code (error type) 

Error message 

How to resolve 

400 (check request parameter) 

请确认卖家权限 

查看卖家ID(vendorid)值是否输入正确 

400 (check request parameter) 

请确认优惠券ID 208463****. 

查看优惠券ID(couponid)值是否输入正确 

400 (check request parameter) 

couponId 1875***查不到该单品 

查看优惠券单品ID(couponitemid)值是否输入正确