Lingxing
切换旧版

查询促销活动列表 - 优惠券

POST/basicOpen/promotionalActivities/coupon/list

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/promotionalActivities/coupon/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必填
优惠券名称
示例 nnn
sidinteger必填
店铺id
示例 2
currency_iconstring必填
货币icon
示例 JP¥
origin_statusstring必填
活动状态:
ACTIVE 进行中
CANCELED 已取消
EXPIRED 已过期
RUNNING 生效中
NEEDS ACTION 需要注意
EXPIRING SOON 即将过期
SUBMITTED 已提交
FAILED 失败
示例 FAILED
discountstring必填
折扣
示例 JP¥11.00
budgetstring必填
预算
示例 JP¥10084.0
coststring必填
支出
示例 0
draw_quantitystring必填
领取数
示例 0
exchange_quantitystring必填
兑换数
示例 0
exchange_ratestring必填
兑换率
示例 15
sales_amountstring必填
活动总销售额
示例 0
sales_volumestring必填
活动总销量
示例 0
promotion_start_timestring必填
活动开始时间【站点时间】
示例 2022-10-14 14:16:48
promotion_end_timestring必填
活动结束时间【站点时间】
示例 2022-10-14 14:17:01
first_sync_timestring必填
首次同步时间【站点时间】
示例 2022-10-14 14:17:34
last_sync_timestring必填
最后同步时间【站点时间】
示例 2022-10-14 14:17:37
remarkstring必填
备注
示例 remark

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "067547ee9d7b437d8247d0117bbb3234.1694486464787",
    "response_time": "2023-09-12 10:41:06",
    "total": 2553,
    "data": [
        {
            "name": "表示価格より ¥11 OFF c23085",
            "sid": 31,
            "currency_icon": "JP¥",
            "origin_status": "FAILED",
            "discount": "JP¥11.00",
            "budget": "JP¥10084.0",
            "cost": "0.00",
            "draw_quantity": "0",
            "exchange_quantity": "0",
            "exchange_rate": "0.00",
            "sales_amount": "0.00",
            "sales_volume": "0",
            "promotion_start_time": "2023-04-08 00:00:00",
            "promotion_end_time": "2023-04-09 00:00:00",
            "first_sync_time": "2023-08-22 11:30:27",
            "last_sync_time": "2023-08-22 11:30:27",
            "remark": ""
        }
    ]
}