Appearance
购买商品
接口状态:
已完成
接口URL:POSThttp://商城域名/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_id | 173 | 是 | Integer | 商品ID |
| buy_number | 1 | 是 | Integer | 购买数量 |
| buy_params | 是 | Object | 购买参数Object | |
| customer_order_id | 666666 | 否 | String | 客户单号,防止重复下单,必须是字符串格式 |
| price | 1.25 | 否 | Float | 客户单价,价格低于当前拿货价将下单失败 |
响应示例
成功(200)
json
{
"code": 0, //状态码
"message": "", //错误信息
"data": {
"id": 100 //订单ID
} //商品列表
}| 参数名 | 参数值 | 参数类型 | 描述说明 |
|---|---|---|---|
| code | 0 | Integer | 状态码 |
| message | String | 错误信息 | |
| data | Object | 商品列表 | |
| data.id | 100 | Integer | 订单ID |
失败(404)
json
{
"code": 1, //状态码
"message": "下单参数匹配无效" //错误信息
}| 参数名 | 参数值 | 参数类型 | 描述说明 |
|---|---|---|---|
| code | 1 | Integer | 状态码 |
| message | 下单参数匹配无效 | String | 错误信息 |