接口

接口预览

• 新增接口 - 再来一单 (批量加入购物车)
• 修改接口 - 获取订单列表
• 新增接口 - 取消订单
• 拓展接口 - 订单状态 关闭/取消状态 退单状态 (order_detail)

订单对应状态 (order_status : number)

• 待付款 (10)
• 待发货 (11)
• 待收货 (12)
• 交易关闭/取消 (13)
• 退单/退款 (14)
• 交易完成 (20)

新增接口 - 再来一单 (批量加入购物车)

POST cart/update_list (参考 cart/update)

1. 入参

    {
      "goods_list":  
        [
        ...
        {
            "amount" : number ,  //购买数量
            "goods_id" : number  //id
        }
        ]
    }

2. 回参

• 成功

    {
    "code": 200,
    "message": "ok"
    }

• 失败

    {
    "code": ?,
    "message": "err",
    "data" : [
        "id" : number , //商品id
        "name" : string , //商品名称
        "err" : string //添加失败的原因 eg:库存 , 下架
            ]
    }

修改接口 - 获取订单列表

POST order/get_basic

1. 入参

• type: number; //获取的类型 (0 待付款) (1 待发货) (2 待收货) (-1 全部)
• offset: number; //偏移值
• limit: number; //一次获取多少个

2. 在入参Type 不同时可以返回的订单类型

• 待付款 (type = 0)
  
  • 待付款 (10 订单状态)
• 待发货 (type = 1)
  
  • 待发货 (11 订单状态)
• 待收货 (type = 2)
  
  • 待收货 (12 订单状态)
• 全部 (type = -1)
  
  • 待付款 待发货 待收货 (type = 10,11,12)
  • 交易关闭/取消 (13 订单状态)
  • 退单/退款 (14 订单状态)
  • 交易完成 (20 订单状态)

3. 返回示例

• 成功 (入参type = 0 返回 未付款订单列表

{
    "code": 200,
    "message": "OK",
    "data": [
        {
            ...
            "status": 10, // 0 (待付款
            "goods_list": [
                {
                    ...
                }
            ],
        }
        ]
}

新增接口 - 取消订单

POST order/close

1.入参

• order_id : number
• reason : string //关闭的原因

2. 请求条件 (不满足请求条件 请求失败)

• 登录
• 有效的订单id
• 订单状态为 待付款 (10

3.返回试例

• 成功 ( 成功后 将订单状态修改为 交易关闭/取消 (13)

{
    "code": 200,
    "message": "ok"
}

• 失败

{
    "code": ?,  //没有定义这个状态码
    "message": "" //错误的原因
}

拓展接口 - 订单状态 关闭/取消状态 退单状态 (待定)

POST order/order_detail

交易关闭/取消 (订单状态为 交易取消/关闭 才会有此字段 )

• 取消的类型 ( close_status: number )
  - 没有取消 0
  - 支付时间超时 (订单状态由待支付 到 关闭 由后台管理) 1
  - 用户主动关闭 ( 只有订单为待支付时才能主动关闭 , 会传递 用户自己选择的取消的原因) 2
  - 后台取消 (因为一些原因后台取消 eg: 太远了 送不了) 3
• 取消的原因 (close_reason : string)
  
  • eg: 太远了 送不了(对应取消 类型 后台关闭) , eg : 支付时间超时 (对应取消类型 支付超时) , eg: 不想买了 (对应取消类型 主动关闭)

退单

• 退单的类型 (return_status : number)
  
  • 没发起退单 (0
  • 已发起退单 (1