获取已绑定的购物卡

接口描述：

  • 获取已绑定的购物卡。

请求 URL：

  • http|https://host/api/v1/card_use/method/get.card.use.list/

请求方式：

  • GET
  • POST

是否授权：

  • 需要授权

业务参数：

参数名 类型 是否必须 范围值 默认值 示例值 描述
card_id integer 否 egt:0 0 0 购物卡编号 0=全部
type string 否 in:normal,invalid normal 筛选类型 normal=正常 invalid=无效
account string 否 max:80 carey 账号或昵称
is_active integer 否 in:0,1 1 是否激活 0=否 1=是
page_no integer 否 gt:0 1 1 页码
page_size integer 否 gt:0 15 15 每页数量

响应参数：

参数名 类型 是否返回 示例值 描述
status integer 是 200 状态码
message string 是 success 消息信息
data object 是 [] 返回对象
data 类型 是否返回 示例值 描述
items array 否 [] 列表项
total_result integer 是 150 合计计数
items 类型 是否返回 示例值 描述
card_use_id integer 是 3 编号
card_id integer 是 2 购物卡编号
user_id integer 是 0 账号编号 0表示未绑定
number string 是 4351713337675868 卡号
password string 是 AA024520B8650882 卡密
money number 是 500 金额
is_active integer 是 0 是否激活 0=否 1=是
is_invalid integer 是 0 是否有效 0=无效 1=有效
remark string 是 作废 备注
active_time datetime 是 2019-05-30 00:00:00 激活时间
get_card object 是 [] 购物卡对象
get_user object 是 [] 账号对象
get_card 类型 是否返回 示例值 描述
card_id integer 是 1 购物卡编号
name string 是 实体购物卡 购物卡名称
description string 是 线下发放 购物卡描述
money number 是 500 购物卡面额
category array 否 ["1","2","3"] 限制商品类目
exclude_category array 否 ["4","5","6"] 排除商品类目
give_num integer 是 100 发放数量
active_num integer 是 0 激活数量
create_time string 是 2018-05-27 00:55:19 创建时间
end_time datetime 否 2019-05-30 00:00:00 截止有效期，空表示不限有效期
status integer 是 1 购物卡状态 0=禁用 1=启用
is_delete integer 是 0 是否删除 0=未删 1=已删
get_user 类型 是否返回 示例值 描述
username string 否 carey 账号
nickname string 否 carey 昵称
head_pic string 否 //host/head_pic.jpg 头像

响应示例：

  1. {
  2.   "status": 200,
  3.   "message": "success",
  4.   "data": {
  5.     "items": [
  6.       {
  7.         "card_use_id": 150,
  8.         "card_id": 1,
  9.         "user_id": 0,
  10.         "number": "9382186216539969",
  11.         "password": "A3239B3C0AD6B10C",
  12.         "money": 500,
  13.         "is_active": 0,
  14.         "is_invalid": 1,
  15.         "remark": "",
  16.         "active_time": "",
  17.         "get_card": {
  18.           "card_id": 1,
  19.           "name": "实体购物卡",
  20.           "description": "线下发放",
  21.           "money": 500,
  22.           "category": [
  23.             "1",
  24.             "2",
  25.             "3"
  26.           ],
  27.           "exclude_category": [
  28.             "4",
  29.             "5",
  30.             "6"
  31.           ],
  32.           "give_num": 100,
  33.           "active_num": 0,
  34.           "create_time": "2018-05-27 00:55:19",
  35.           "end_time": "2019-05-30 00:00:00",
  36.           "status": 1,
  37.           "is_delete": 0
  38.         },
  39.         "get_user": {
  40.           "username": null,
  41.           "nickname": null,
  42.           "head_pic": null
  43.         }
  44.       },
  45.       {
  46.         "card_use_id": 149,
  47.         "card_id": 2,
  48.         "user_id": 0,
  49.         "number": "6933552917128137",
  50.         "password": "0764CBBB5296EA19",
  51.         "money": 500,
  52.         "is_active": 0,
  53.         "is_invalid": 1,
  54.         "remark": "",
  55.         "active_time": "",
  56.         "get_card": {
  57.           "card_id": 2,
  58.           "name": "电子购物卡",
  59.           "description": "线上购买",
  60.           "money": 500,
  61.           "category": [],
  62.           "exclude_category": [],
  63.           "give_num": 50,
  64.           "active_num": 0,
  65.           "create_time": "2018-05-27 01:59:21",
  66.           "end_time": "",
  67.           "status": 1,
  68.           "is_delete": 0
  69.         },
  70.         "get_user": {
  71.           "username": null,
  72.           "nickname": null,
  73.           "head_pic": null
  74.         }
  75.       }
  76.     ],
  77.     "total_result": 150
  78.   }
  79. }

备注:

  1. 该接口支持条件搜索，如果不带入业务参数则使用默认值。