Skip to content

购买商品

接口状态: 已完成
接口URL: POST http://商城域名/openapi/customer/Goods/Buy
Content-Type:application/json
认证方式: 无需认证

Body请求参数

json
{
  "goods_id": 102, //商品ID
  "buy_number": 1, //购买数量
  "buy_params": {
    "qq": "123456"

  }, //购买参数Object
  "customer_order_id": "12345", //客户单号,防止重复下单,必须是字符串格式
  "price": 0.01 //客户单价,价格低于当前拿货价降下单失败
}
参数名参数值是否必填参数类型描述说明
goods_id173Integer商品ID
buy_number1Integer购买数量
buy_paramsObject购买参数Object
customer_order_id666666String客户单号,防止重复下单,必须是字符串格式
price1.25Float客户单价,价格低于当前拿货价将下单失败

响应示例

成功(200)

json
{
  "code": 0, //状态码
  "message": "", //错误信息
  "data": {
    "id": 100 //订单ID
  } //商品列表
}
参数名参数值参数类型描述说明
code0Integer状态码
messageString错误信息
dataObject商品列表
data.id100Integer订单ID

失败(404)

json
{
  "code": 1, //状态码
  "message": "下单参数匹配无效" //错误信息
}
参数名参数值参数类型描述说明
code1Integer状态码
message下单参数匹配无效String错误信息