Lingxing
切换旧版

查询促销活动列表 - 管理促销

POST/basicOpen/promotionalActivities/manage/list

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/promotionalActivities/manage/listHTTPSPOST1

请求参数

start_datestring
开始日期【活动时间】,站点时间,闭区间,格式:Y-m-d,时间间隔最长不超过90天
end_datestring
结束日期【活动时间】,站点时间,闭区间,格式:Y-m-d,时间间隔最长不超过90天
sidsarray<any>
店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
offsetinteger
分页偏移量,默认0
lengthinteger
分页长度,默认20,上限200

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 77ac259a67d5462594c83b80669b6eae.1692331008758
response_timestring必填
响应时间
示例 2023-08-18 11:56:49
totalinteger必填
总数
示例 200
dataarray<object>必填
响应数据
隐藏子属性
promotion_idstring必填
促销活动id
namestring必填
内部描述
示例 Save $1 on swi... VPC-1-138675244 Coupon
sidinteger必填
店铺id
示例 2
promotion_typeinteger必填
活动类型:
3 买一赠一
4 购买折扣
5 一口价
8 社媒促销
示例 4
currency_iconstring必填
货币icon
origin_statusstring必填
活动状态:
ACTIVE 进行中
CANCELED 已取消
EXPIRED 已过期
PENDING 未开始
示例 EXPIRED
promotion_codestring必填
优惠码
示例 不需要
sales_amountstring必填
活动总销售额
示例 0
sales_volumestring必填
活动总销量
示例 0
participate_conditionstring必填
参与条件
示例 At least this quantity of items\n80
participate_condition_numstring必填
参与条件数值
示例 0
buyer_getsstring必填
买家获得
示例 Percent off\n1
buyer_gets_numstring必填
买家获得值
示例 0
purchase_productstring必填
需购买商品
示例 足球
discount_productstring必填
优惠商品
示例 计算机
exclude_productstring必填
排除商品
示例 遥控器
exchange_limitinteger必填
是否限制兑换:
1 是
0 否
示例 0
promotion_start_timestring必填
活动开始时间【站点时间】
示例 2022-08-26 02:00:00
promotion_end_timestring必填
活动结束时间【站点时间】
示例 2022-08-26 23:00:59
first_sync_timestring必填
首次同步时间【站点时间】
示例 2022-10-11 10:17:26
last_sync_timestring必填
最后同步时间【站点时间】
示例 2022-10-11 10:17:26
remarkstring必填
备注

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "90930764718445a4af61b88a655ef10b.1694510506428",
    "response_time": "2023-09-12 17:21:47",
    "data": [
        {
            "name": "sss测试",
            "sid": 31,
            "promotion_type": 4,
            "currency_icon": "JP¥",
            "origin_status": "EXPIRED",
            "promotion_code": "不需要",
            "sales_amount": "0.00",
            "sales_volume": "0",
            "participate_condition": "At least this quantity of items\n80",
            "participate_condition_num": "80",
            "buyer_gets": "Percent off\n1",
            "buyer_gets_num": "1",
            "purchase_product": "测试1",
            "discount_product": "测试1",
            "exclude_product": "",
            "exchange_limit": "0",
            "promotion_start_time": "2023-01-10 10:00:00",
            "promotion_end_time": "2023-01-10 23:59:00",
            "first_sync_time": "2023-02-22 11:53:04",
            "last_sync_time": "2023-02-23 17:34:32",
            "remark": ""
        }
    ],
    "total": 1
}