> For the complete documentation index, see [llms.txt](https://mamba-dongdong.gitbook.io/pc-im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mamba-dongdong.gitbook.io/pc-im/you-hui-quan/you-hui-quan-lie-biao.md).

# 优惠券列表

本文档中，介绍了发送优惠券时，获取的优惠券列表。

#### 请求说明

```
POST https://ms.shougongker.com/index.php?c=Pc&a=coupons  HTTP/1.1
Content-Type: application/x-www-form-urlencoded;charset=utf-8
```

请求中Headers的设置请参考[接口概述](https://mamba-dongdong.gitbook.io/pc-im/jie-kou-gai-shu)

#### 请求参数

| 字段名  | 变量名  | 必填 | 类型  | 示例值    | 描述                |
| ---- | ---- | -- | --- | ------ | ----------------- |
| 用户ID | uid  | 是  | int | 165191 | 当前登陆PC IM用户的手工客ID |
| 页码   | page | 否  | int | 1      | 商品列表的页码，默认为1      |

#### 返回结果

| 字段名  | 变量名    | 必填 | 类型     | 示例值 | 描述                                         |
| ---- | ------ | -- | ------ | --- | ------------------------------------------ |
| 状态码  | status | 是  | int    | 200 | 状态码                                        |
| 返回信息 | info   | 否  | string | ok  | 接口具体状态信息                                   |
| 数据   | data   | 是  | object |     | 接口返回的具体数据，如果数据为空，则data为空对象，具体数据在data对面里面体现 |

#### 返回示例

```
{
    "status": 200,
    "info": "ok",
    "data": {
        "list": {
            "list": [
                {
                    "id": 1,
                    "name": "满99减5元",
                    "type": "满减券",
                    "range": "全部商品",
                    "threshold": "满99",
                    "status": "未过期",
                    "expire": "2019-03-12至2020-06-21"
                },
                {
                    "id": 2,
                    "name": "满87减2元",
                    "type": "满减券",
                    "range": "全部商品",
                    "threshold": "满87",
                    "status": "已过期",
                    "expire": "2019-03-11至2019-09-13"
                },
                {
                    "id": 3,
                    "name": "满99减5",
                    "type": "满减券",
                    "range": "全部商品",
                    "threshold": "满99",
                    "status": "未过期",
                    "expire": "2019-03-11至2019-11-07"
                },
                {
                    "id": 4,
                    "name": "满99打9.7折",
                    "type": "折扣券",
                    "range": "全部商品",
                    "threshold": "满99",
                    "status": "已过期",
                    "expire": "2019-03-14至2019-07-19"
                },
                {
                    "id": 5,
                    "name": "满100减30",
                    "type": "满减券",
                    "range": "部分商品",
                    "threshold": "无门槛",
                    "status": "未过期",
                    "expire": "领券当日起5日内有效"
                },
                {
                    "id": 6,
                    "name": "满100减20",
                    "type": "满减券",
                    "range": "部分商品",
                    "threshold": "满100",
                    "status": "未过期",
                    "expire": "领券当日起12日内有效"
                },
                {
                    "id": 18,
                    "name": "满999打9.9折",
                    "type": "折扣券",
                    "range": "部分商品",
                    "threshold": "满999",
                    "status": "已过期",
                    "expire": "2019-03-18至2019-01-31"
                },
                {
                    "id": 19,
                    "name": "满888打88折",
                    "type": "折扣券",
                    "range": "全部商品",
                    "threshold": "满888",
                    "status": "已过期",
                    "expire": "2019-03-02至2019-03-22"
                },
                {
                    "id": 35,
                    "name": "折扣券1",
                    "type": "折扣券",
                    "range": "全部商品",
                    "threshold": "满99",
                    "status": "未过期",
                    "expire": "领券当日起3日内有效"
                },
                {
                    "id": 36,
                    "name": "折扣券2",
                    "type": "折扣券",
                    "range": "部分商品",
                    "threshold": "满99",
                    "status": "未过期",
                    "expire": "领券当日起3日内有效"
                }
            ],
            "totalPage": 18
        }
    }
}
```