Lingxing
切换旧版

查询商品折扣详情 - 列表 - 优惠券

POST/basicOpen/promotion/listingDetailCoupon

接口信息

API Path请求协议请求方式[令牌桶容量]()
/basicOpen/promotion/listingDetailCouponHTTPSPOST1

请求参数

sellerSkustring必填
seller_sku(msku)
promotionTypearray<any>
促销类型
statusarray<any>
促销状态： 0 其他 1 进行中 2 已过期 3 未开始
storeIdstring必填
店铺id
startTimestring必填
活动开始时间
endTimestring必填
活动结束时间
sortFieldstring必填
排序项（"cost", "drawQuantity", "exchangeQuantity", "exchangeRate","startTime","salesVolume","salesAmount","startTime"）
sortTypestring必填
排序类型 asc desc
pageNumnumber必填
分页页码
pageSizenumber必填
分页大小

请求示例

{
   
    "sellerSku": "7T-2COF-AV9I",
    "promotionType": [],
    "status": [],
    "storeId": "43",
    "startTime": "2024-09-10",
    "endTime": "2024-09-12",
    "sortField": "startTime",
    "sortType": "desc",
    "pageNum": 1,
    "pageSize": 20
}

返回结果

Json Object

codenumber必填
状态码，0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
示例 []
request_idstring必填
请求链路id
示例 9ed6f7bca84d4768a1c374ef8865e263.1752196903523
response_timestring必填
响应时间
示例 2025-07-11 09:21:44
dataobject必填
隐藏子属性
totalnumber必填
总数
示例 1
sizenumber必填
示例 20
pageCountnumber必填
示例 1
currentnumber必填
示例 1
currentSizenumber必填
示例 1
hasPreviousPageboolean必填
示例 false
hasNextPageboolean必填
示例 false
recordsarray<object>必填
隐藏子属性
promotionIdstring必填
优惠券id
示例 aec82146-b1c3-46ed-b044-05d4b0e8baf5
namestring必填
优惠券名称
示例 Save 5% on asdfasdfa
storeIdstring必填
店铺id
示例 43
storeNamestring必填
店铺名
示例 uboss-US
regionNamestring必填
国家/地区
示例 美国
currencyIconstring必填
货币icon
示例 $
statusnumber必填
商品状态：1 active，2 draft，3 archived，4 deleted
示例 2
needsAttentionboolean必填
状态
示例 false
statusTextstring必填
状态
示例 已过期
originStatusstring必填
活动状态： ACTIVE 进行中 CANCELED 已取消 EXPIRED 已过期 RUNNING 生效中 NEEDS ACTION 需要注意 EXPIRING SOON 即将过期 SUBMITTED 已提交 FAILED 失败
示例 EXPIRED
originStatusTextstring必填
活动状态
示例 已过期
discountstring必填
折扣
示例 5.00%
budgetstring必填
预算
示例 $100
costnumber必填
支出
示例 0
drawQuantitynumber必填
领取数
示例 0
exchangeQuantitynumber必填
兑换数
示例 0
exchangeRatenumber必填
兑换率
示例 0
salesAmountnumber必填
活动总销售额
示例 0
salesAmountUsdnumber必填
活动总销售额，换算成美元
示例 0
salesVolumenumber必填
活动总销量
示例 0
promotionStartTimestring必填
活动开始时间
示例 2024-09-10 00:00:00
promotionStartTimeUtcstring必填
活动开始时间UTC时间
示例 null
promotionEndTimestring必填
活动结束时间
示例 2024-09-12 00:00:00
firstSyncTimestring必填
首次同步时间
示例 2024-11-07 10:36:28
lastSyncTimestring必填
最后同步时间
示例 2024-11-07 17:25:19
remarkstring必填
备注
totalnumber必填
总数
示例 1

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "9ed6f7bca84d4768a1c374ef8865e263.1752196903523",
    "response_time": "2025-07-11 09:21:44",
    "data": {
        "total": 1,
        "size": 20,
        "pageCount": 1,
        "current": 1,
        "currentSize": 1,
        "hasPreviousPage": false,
        "hasNextPage": false,
        "records": [{
            "promotionId": "aec82146-b1c3-46ed-b044-05d4b0e8baf5",
            "name": "Save 5% on asdfasdfa",
            "storeId": "43",
            "storeName": "uboss-US",
            "regionName": "美国",
            "currencyIcon": "$",
            "status": 2,
            "needsAttention": false,
            "statusText": "已过期",
            "originStatus": "EXPIRED",
            "originStatusText": "已过期",
            "discount": "5.00%",
            "budget": "$100",
            "cost": 0,
            "drawQuantity": 0,
            "exchangeQuantity": 0,
            "exchangeRate": 0,
            "salesAmount": 0,
            "salesAmountUsd": 0,
            "salesVolume": 0,
            "promotionStartTime": "2024-09-10 00:00:00",
            "promotionStartTimeUtc": null,
            "promotionEndTime": "2024-09-12 00:00:00",
            "firstSyncTime": "2024-11-07 10:36:28",
            "lastSyncTime": "2024-11-07 17:25:19",
            "remark": ""
        }]
    },
    "total": 1
}