接口描述:

  • 添加一条购物卡。

请求 URL:

  • http|https://host/api/v1/card/method/add.card.item/

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
name string max:50 实体购物卡 购物卡名称
description string max:255 线下发放 购物卡描述
money number gt:0 500 购物卡面额
category array gt[]:0 [1,2,3] 限制商品类目
exclude_category array gt[]:0 [4,5,6] 排除商品类目
give_num integer gt:0 100 发放数量
end_time datetime date 2019-05-30 00:00:00 截止有效期
status integer in:0,1 1 1 购物卡状态 0=禁用 1=启用

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
name string 实体购物卡 购物卡名称
description string 线下发放 购物卡描述
money number 500 购物卡面额
category array ["1","2","3"] 限制商品类目
exclude_category array ["4","5","6"] 排除商品类目
give_num integer 100 发放数量
end_time datetime 2019-05-30 00:00:00 截止有效期
status integer 1 购物卡状态 0=禁用 1=启用
create_time string 2018-05-27 00:55:19 创建时间
card_id integer 1 购物卡编号

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "name": "实体购物卡",
  6. "description": "线下发放",
  7. "money": 500,
  8. "category": [
  9. "1",
  10. "2",
  11. "3"
  12. ],
  13. "exclude_category": [
  14. "4",
  15. "5",
  16. "6"
  17. ],
  18. "give_num": 100,
  19. "end_time": "2019-05-30 00:00:00",
  20. "status": 1,
  21. "create_time": "2018-05-27 00:55:19",
  22. "card_id": 1
  23. }
  24. }

备注:

  1. 不传入参数end_time则表示不限制截止有效时间

  2. categoryexclude_category参数中的分类编号,如果该分类下有子分类,则有同样效果。

  3. 限制表示只能在指定范围内使用,排除表示指定的商品类目不参与。

文档更新时间: 2018-05-27 01:58