# 获取限时抢购任务列表
本接口已重新上线,状态(status)字段含义有修改,请仔细阅读。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/product/limiteddiscounttask/list/get?access_token=ACCESS_TOKEN
# 请求参数示例
{
"status": 0,
"page_size": 10,
"next_key": "THE_NEXT_KEY"
}
# 回包示例
{
"errcode": 0,
"errmsg": "ok",
"limited_discount_tasks": [
{
"task_id": "12345677",
"product_id": "12345678001",
"status": 0,
"create_time": 1660047026,
"start_time": 1660046940,
"end_time": 1662293399,
"limited_discount_skus": [
{
"sku_id": "1234567890001",
"sale_price": 200,
"sale_stock": 10
},
{
"sku_id": "1234567890002",
"sale_price": 300,
"sale_stock": 10
}
]
},
{
"task_id": "12345688",
"product_id": "12345678002",
"status": 0,
"create_time": 1659516539,
"start_time": 1659516420,
"end_time": 1662022079,
"limited_discount_skus": [
{
"sku_id": "12345678900013",
"sale_price": 20,
"sale_stock": 6
}
]
}
],
"next_key": "THE_NEXT_KEY_NEW",
"total_num": 2
}
# 请求参数说明
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
status | number | 否 | 需要获取的抢购活动状态,status为0代表还未开始的限时抢购任务,status为1代表进行中的限时抢购任务,status为2代表已结束的限时抢购任务。如果不填status,则3种状态的任务都会获取。 |
page_size | number | 是 | 每页数量(默认10,不超过50) |
next_key | string | 否 | 由上次请求返回,记录翻页的上下文。传入时会从上次返回的结果往后翻一页,不传默认获取第一页数据 |
# 回包参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
limited_discount_tasks[].task_id | string(uint64) | 限时抢购任务ID |
limited_discount_tasks[].product_id | string(uint64) | 抢购商品ID |
limited_discount_tasks[].status | number | 限时抢购任务状态 |
limited_discount_tasks[].create_time | number | 限时抢购任务创建时间(秒级时间戳) |
limited_discount_tasks[].start_time | number | 限时抢购任务开始时间(秒级时间戳) |
limited_discount_tasks[].end_time | number | 限时抢购任务结束时间(秒级时间戳) |
limited_discount_tasks[].limited_discount_skus[].sku_id | string(uint64) | 限时抢购任务下不同的sku_id |
limited_discount_tasks[].limited_discount_skus[].sale_price | number | 该sku_id的抢购价格 |
limited_discount_tasks[].limited_discount_skus[].sale_stock | number | 该sku_id的设置时的抢购数量 |
next_key | string | 本次翻页的上下文,用于请求下一页 |
total_num | number | 商品总数 |
# 回包status取值说明
枚举值 | 描述 |
---|---|
0 | 抢购活动创建完成,未开始,此时不能直接调用删除接口 |
1 | 抢购活动进行中,此时不能直接调用删除接口 |
2 | 抢购活动已结束 |
# 返回码
返回码 | 错误类型 |
---|---|
公共错误码 | 点击查看 |
10020050 | 无权限调用该api |
10020051 | 参数有误 |