接口描述:

  • 获取已绑定的购物卡。

请求 URL:

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

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
type string in:normal,invalid normal 筛选类型 normal=正常 invalid=无效
page_no integer gt:0 1 1 页码
page_size integer between:1,40 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_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=已删

响应示例:

  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. },
  40. {
  41. "card_use_id": 149,
  42. "card_id": 2,
  43. "user_id": 0,
  44. "number": "6933552917128137",
  45. "password": "0764CBBB5296EA19",
  46. "money": 500,
  47. "is_active": 0,
  48. "is_invalid": 1,
  49. "remark": "",
  50. "active_time": "",
  51. "get_card": {
  52. "card_id": 2,
  53. "name": "电子购物卡",
  54. "description": "线上购买",
  55. "money": 500,
  56. "category": [],
  57. "exclude_category": [],
  58. "give_num": 50,
  59. "active_num": 0,
  60. "create_time": "2018-05-27 01:59:21",
  61. "end_time": "",
  62. "status": 1,
  63. "is_delete": 0
  64. }
  65. }
  66. ],
  67. "total_result": 150
  68. }
  69. }

备注:

  1. 该接口支持条件搜索,如果不带入业务参数则使用默认值。
文档更新时间: 2018-06-21 17:20