Lingxing
切换旧版

查询商品折扣详情 - 列表 - 管理促销

POST/basicOpen/promotion/listingDetailManage

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/promotion/listingDetailManageHTTPSPOST1

请求参数

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

请求示例

{

    "sellerSku": "31-250J-NKH6",
    "promotionType": [],
    "status": [],
    "storeId": "132",
    "startTime": "2023-01-01",
    "endTime": "2023-01-31",
    "sortField": "startTime",
    "sortType": "desc",
    "pageNum": 1,
    "pageSize": 20
}

返回结果

Json Object

codenumber必填
消息提示
示例 0
messagestring必填
消息
示例 success
error_detailsarray<any>必填
错误信息
示例 []
request_idstring必填
请求id
示例 c6ed840963a24d3e9805ca03b269f51b.1752205194893
response_timestring必填
响应时间
示例 2025-07-11 11:40:01
dataobject必填
隐藏子属性
totalnumber必填
示例 1
sizenumber必填
示例 20
pageCountnumber必填
示例 1
currentnumber必填
示例 1
currentSizenumber必填
示例 1
hasNextPageboolean必填
示例 false
hasPreviousPageboolean必填
示例 false
recordsarray<object>必填
隐藏子属性
promotionIdstring必填
活动id，唯一标识
示例 VPC-6-14498719 Coupon
namestring必填
名称-内部描述
trackingIdstring必填
追踪编码
示例 VPC-6-14498719 Coupon
storeIdstring必填
店铺id
示例 132
storeNamestring必填
店铺名
示例 feifan-JP1
regionNamestring必填
国家/地区名
示例 日本
currencyIconstring必填
货币icon
示例 JP¥
statusnumber必填
状态
示例 2
statusTextstring必填
状态
示例 已过期
originStatusstring必填
促销活动平台状态
示例 EXPIRED
originStatusTextstring必填
促销活动平台状态
示例 已过期
promotionTypenumber必填
促销类型
示例 0
promotionTypeTextstring必填
促销类型
示例 未定义类型
promotionCodestring必填
优惠码
promotionCodeTypestring必填
优惠码类型，1优先型，2无限型
示例 null
salesAmountnumber必填
活动总销售额
示例 0
salesAmountUsdnumber必填
活动总销售额，换算成美元
示例 0
salesVolumenumber必填
活动总销量
示例 0
participateConditionstring必填
参与条件
participateConditionNumnumber必填
参与条件数值
示例 0
buyerGetsstring必填
买家获得
buyerGetsNumnumber必填
买家获得值
示例 0
purchaseProductstring必填
需购买商品
discountProductstring必填
优惠商品
excludeProductstring必填
排除商品
exchangeLimitnumber必填
是否限制兑换，1是0否
示例 0
promotionStartTimestring必填
活动开始时间
示例 2023-01-02 00:00:00
promotionStartTimeUtcstring必填
活动开始时间Utc
示例 null
promotionEndTimestring必填
活动结束时间
示例 2023-01-03 23:59:00
firstSyncTimestring必填
首次同步时间
示例 2023-03-06 18:15:41
lastSyncTimestring必填
最后同步时间
示例 2024-01-09 14:13:20
remarkstring必填
备注
totalnumber必填
示例 1

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "c6ed840963a24d3e9805ca03b269f51b.1752205194893",
    "response_time": "2025-07-11 11:40:01",
    "data": {
        "total": 1,
        "size": 20,
        "pageCount": 1,
        "current": 1,
        "currentSize": 1,
        "hasNextPage": false,
        "hasPreviousPage": false,
        "records": [{
            "promotionId": "VPC-6-14498719 Coupon",
            "name": "",
            "trackingId": "VPC-6-14498719 Coupon",
            "storeId": "132",
            "storeName": "feifan-JP1",
            "regionName": "日本",
            "currencyIcon": "JP¥",
            "status": 2,
            "statusText": "已过期",
            "originStatus": "EXPIRED",
            "originStatusText": "已过期",
            "promotionType": 0,
            "promotionTypeText": "未定义类型",
            "promotionCode": "",
            "promotionCodeType": null,
            "salesAmount": 0,
            "salesAmountUsd": 0,
            "salesVolume": 0,
            "participateCondition": "",
            "participateConditionNum": 0,
            "buyerGets": "",
            "buyerGetsNum": 0,
            "purchaseProduct": "",
            "discountProduct": "",
            "excludeProduct": "",
            "exchangeLimit": 0,
            "promotionStartTime": "2023-01-02 00:00:00",
            "promotionStartTimeUtc": null,
            "promotionEndTime": "2023-01-03 23:59:00",
            "firstSyncTime": "2023-03-06 18:15:41",
            "lastSyncTime": "2024-01-09 14:13:20",
            "remark": ""
        }]
    },
    "total": 1
}