BookStore-PJ2/doc/buyer.md

买家下单

URL：

POST http://[address]/buyer/new_order

Request

Header:

key	类型	描述	是否可为空
token	string	登录产生的会话标识	N

Body:

{
  "user_id": "buyer_id",
  "store_id": "store_id",
  "books": [
    {
      "id": "1000067",
      "count": 1
    },
    {
      "id": "1000134",
      "count": 4
    }
  ]
}

属性说明：

变量名	类型	描述	是否可为空
user_id	string	买家用户ID	N
store_id	string	商铺ID	N
books	class	书籍购买列表	N

books数组：

变量名	类型	描述	是否可为空
id	string	书籍的ID	N
count	string	购买数量	N

Response

Status Code:

码	描述
200	下单成功
5XX	买家用户ID不存在
5XX	商铺ID不存在
5XX	购买的图书不存在
5XX	商品库存不足

Body:

{
  "order_id": "uuid"
}

属性说明：

变量名	类型	描述	是否可为空
order_id	string	订单号，只有返回200时才有效	N

买家付款

URL：

POST http://[address]/buyer/payment

Request

Body:

{
  "user_id": "buyer_id",
  "order_id": "order_id",
  "password": "password"
}

属性说明：

变量名	类型	描述	是否可为空
user_id	string	买家用户ID	N
order_id	string	订单ID	N
password	string	买家用户密码	N

Response

Status Code:

码	描述
200	付款成功
5XX	账户余额不足
5XX	无效参数
401	授权失败

买家充值

URL：

POST http://[address]/buyer/add_funds

Request

Body:

{
  "user_id": "user_id",
  "password": "password",
  "add_value": 10
}

属性说明：

key	类型	描述	是否可为空
user_id	string	买家用户ID	N
password	string	用户密码	N
add_value	int	充值金额，以分为单位	N

Status Code:

码	描述
200	充值成功
401	授权失败
5XX	无效参数

买家收货

URL

POST http://[address]/buyer/take_over

Request

Headers:

key	类型	描述	是否可为空
token	string	登录产生的会话标识	N

Body:

{
  "user_id": "$seller id$",
  "order_id": "$store id$",
}

key	类型	描述	是否可为空
user_id	String	买家用户ID	N
order_id	String	订单号	N

Response

Status Code:

码	描述
200	收货成功
5XX	买家用户ID不存在
5XX	无效参数

买家取消订单

URL

POST http://[address]/buyer/order_cancel

Request

Headers:

key	类型	描述	是否可为空
token	string	登录产生的会话标识	N

Body:

{
  "user_id": "$seller id$",
  "order_id": "$store id$",
}

key	类型	描述	是否可为空
user_id	String	买家用户ID	N
order_id	String	订单号	N

Response

Status Code:

码	描述
200	收货成功
5XX	买家用户ID不存在
5XX	无效参数

历史订单查询

URL

POST http://[address]/buyer/history_order

Request

Headers:

key	类型	描述	是否可为空
token	string	登录产生的会话标识	N

Body:

{
  "user_id": "$buyer id$"
}

key	类型	描述	是否可为空
user_id	String	买家用户ID	N

Response

Status Code:

码	描述
200	查询成功
5XX	买家用户ID不存在
5XX	无效参数

Body:

{
  "order_id": ["uuid"]
}

变量名	类型	描述	是否可为空
order_id	string	订单号，只有返回200时才有效	N