# 获取限时抢购任务列表
# 接口说明
可通过该接口获取限时抢购任务
# 注意事项
本接口已重新上线，限时抢购任务状态status字段含义有修改，可参考枚举值status，请仔细阅读。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/product/limiteddiscounttask/list/get?access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| status | number | 否 | 指定获取某个status状态下的限时抢购任务列表，status枚举值含义可参考status，如果不填，则获取所有状态下的限时抢购任务列表 |
| page_size | number | 是 | 每页数量(默认10，不超过50) |
| next_key | string | 否 | 由上次请求返回，记录翻页的上下文，传入时会从上次返回的结果往后翻一页，不传默认获取第一页数据 |
# 请求参数示例
{
"status": 0,
"page_size": 10,
"next_key": "THE_NEXT_KEY"
}
# 返回参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| 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 | 商品总数 |
# 返回参数示例
{
"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
}
# 错误码
| 错误码 | 错误描述 |
|---|---|
| 公共错误码 | - |
| 10020050 | 无权限调用该api，请开发者获取权限后再试 |
| 10020051 | 参数有误，请检查请求参数是否正确 |
# 枚举值
# status
限时抢购任务状态
| 枚举值 | 描述 |
|---|---|
| 0 | 限时抢购任务创建完成，未开始，此时不能直接调用删除接口 |
| 1 | 限时抢购任务进行中，此时不能直接调用删除接口 |
| 2 | 限时抢购任务已结束 |