获取列表 - 人人商城V5开放接口

请求参数

Query 参数

keywords

string

搜索关键字

可选

示例值:

满100减10块

coupon_sale_type

integer

可选

优惠类型 1满减 2折扣

示例值:

1

status

integer

可选

1发放中 2未发放 3已领完 4已过期

示例值:

1

pick_way

integer

可选

领取方式 1免费 2付费 3链接领取

示例值:

1

is_validity

integer

可选

有效期仅获取未过期的

示例值:

1

page

integer

查询页

可选

示例值:

1

page_size

integer

每页数量

可选

示例值:

10

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET '/coupon/list?keywords=满100减10块&coupon_sale_type=1&status=1&pick_way=1&is_validity=1&page=1&page_size=10'

返回响应

🟢200成功

application/json

Body

error

integer

必需

出错返回码，为0表示成功，非0表示调用失败

total

integer

列表总数

必需

list

array [object {12}]

优惠券列表

必需

id

string

自增ID

必需

coupon_name

string

名称

必需

create_time

string

创建时间

必需

coupon_sale_type

string

必需

优惠类型 1满减 2折扣

stock_type

string

必需

发送数量限制 0不限制 1自定义

get_total

string

已领取数量

必需

stock

string

剩余库存

必需

content

string

优惠内容

必需

surplus

integer

剩余数量 18

可选

wxapp_url

string

小程序页面地址

必需

status

string

优惠券状态

必需

status_text

string

优惠券状态文字

必需

page

integer

当前页

必需

page_size

integer

每页数量

必需

coupon_sale_type_map

array [object {2}]

优惠类型映射

必需

type

integer

必需

优惠类型 1满减 2折扣

text

string

文字

必需

示例

{
  "error": 0,
  "total": 2,
  "list": [
    {
      "id": "48",
      "coupon_name": "有库存",
      "create_time": "2020-06-11 09:07:50",
      "coupon_sale_type": "2",
      "stock_type": "1",
      "get_total": "12",
      "stock": "30",
      "content": "满100享9折",
      "surplus": 18,
      "wxapp_url": "/pagesMember/coupon/detail/index?id=48",
      "status": "4",
      "status_text": "已过期"
    },
    {
      "id": "47",
      "coupon_name": "活动领取",
      "create_time": "2020-06-06 17:17:25",
      "coupon_sale_type": "1",
      "stock_type": "0",
      "get_total": "86",
      "stock": "0",
      "content": "满100减10",
      "wxapp_url": "/pagesMember/coupon/detail/index?id=47",
      "status": "4",
      "status_text": "已过期"
    }
  ],
  "page": 1,
  "page_size": 20,
  "coupon_sale_type_map": [
    {
      "type": 1,
      "text": "立减"
    },
    {
      "type": 2,
      "text": "折扣"
    }
  ]
}