POST
/v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items2609170000[立减优惠券] 添加产品单品
# 01
简介
[立减优惠券] 添加产品单品
# 02
详细内容
API支持的买家用户地区：韩国
该API用于将创建的优惠券添加至单件商品。本API是异步的方式，仅执行处理请求。
可使用响应的“requestedId”值，通过确认请求状态API来查看实际API 执行结果值。
请在添加产品到立减优惠券的时候谨慎选择产品列表，因为此立减优惠券创建之后卖家就无法对优惠券的产品列表进行删除操作。如果您确实需要删除其中的一些产品，请暂停旧的优惠券，创建新的立减优惠券，并添加新的产品列表。
路径
POST/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/68/items# 03
Path 参数
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
| couponId* | number | 要使用的优惠券ID
|
# 04
请求体参数
请求参数
请求体参数
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
| couponId* | number | 要使用的优惠券ID
|
| vendorItems* | object[] | 要添加优惠券的属性ID 一次最多可添加10,000件属性ID |
| code | string | 服务器返回码
|
| message | string | 服务器返回消息
|
| errorMessage | string | 错误详情，HTTP 状态码为 200 时，无错误信息
|
| data | string | 请求成功与否的数据
|
| success data.success | string | 真或假
|
| content data.content | string | 可查看处理状态的请求ID数据
|
| requestedId data.content.requestedId | string | 查看处理状态的请求ID e.g. 1542675975663862164 |
| success data.content.success | string | 真或假
|
| Pagination data.Pagination | string | 无分页
|
| 400 (check parameter requested) | string | 查看优惠券ID（couponid）值是否输入正确。
|
请求示例application/json
{
"vendorItems": [
3226138951,
3226138847
]
}# 05
响应体
响应消息
| Name | Type | Description |
|---|---|---|
| code | integer | 服务器返回码
|
| message | string | 服务器返回消息
|
| httpStatus | integer | HTTP 状态码（与服务器返回码相同）
|
| httpStatusMessage | string | HTTP 状态消息（与服务器返回消息相同）
|
| errorMessage | string | 错误详情，HTTP 状态码为 200 时，无错误信息
|
| data | object | 请求成功与否的数据
|
| success data.success | boolean | 真或假
|
| content data.content | object | 可查看处理状态的请求ID数据
|
| requestedId data.content.requestedId | string | 查看处理状态的请求ID e.g. 1542675975663862164 |
| success data.content.success | boolean | 真或假
|
| Pagination data.Pagination | object[] | 无分页
|
Response Example
{
"code": 200,
"message": "OK",
"httpStatus": 200,
"httpStatusMessage": "OK",
"errorMessage": "",
"data": {
"success": true,
"content": {
"requestedId": "17258005702255081464",
"success": true
},
"pagination": null
}
}# 06
错误码
| HTTP | 代码 | 消息 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
错误说明
| HTTP | 类型 | 错误消息 | 解决方案 |
|---|---|---|---|
| 400 | 400 (check parameter requested) | vendorItems可能不为空，数量必须要1和10000之间。 | 查看要添加优惠券的属性ID（vendoritems）是否输入正确。 一次最多添加10,000件属性ID。 |
| 400 | 400 (check parameter requested) | 请确认卖家权限。 | 查看卖家ID（vendorid）值是否输入正确。 |
| 400 | 400 (check parameter requested) | 请确认优惠券ID 208463**** | 查看优惠券ID（couponid）值是否输入正确。 |