创建订单接口
创建用户购物订单,支持单个商品或多个商品下单,可指定收货地址、优惠券等信息。
注意事项
- 该接口采用POST方法,需要以application/json格式提交数据
- 需要用户登录后才能访问
- 订单状态为待付款状态,等待用户支付
- 可以通过商品ID或商品详情列表创建订单
- 支持使用优惠券和指定收货地址
请求地址
{域名地址}/api/order/create
说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/order/create
请求语法
POST {域名地址}/api/order/create
Content-Type: application/json
请求头
此接口还涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。
请求参数
| 字段名 |
类型 |
必填 |
说明 |
| goods_id |
int |
否 |
商品ID,单个商品下单时可使用 |
| quantity |
int |
否 |
商品数量,单个商品下单时可使用 |
| goods_sku_id |
int |
否 |
SKU ID,单个商品下单时可使用 |
| details |
object[] |
否 |
多个商品信息,goods_id 和 details 必须传一个 |
| remark |
string |
否 |
订单备注 |
| type |
string |
否 |
订单类型,goods、vip |
| coupon_code |
string |
否 |
优惠券码 |
| coupon_code_id |
int |
否 |
优惠券码ID |
| coupon_id |
int |
否 |
优惠券ID,满减类型的优惠券 |
| address |
object |
否 |
收件地址信息 |
| cart_ids |
int[] |
否 |
购物车ID列表 |
details item 参数
| 字段名 |
类型 |
必填 |
说明 |
| goods_id |
int |
是 |
商品ID |
| quantity |
int |
是 |
商品数量 |
address 参数
| 字段名 |
类型 |
必填 |
说明 |
| id |
int |
否 |
地址ID |
| name |
string |
是 |
收件人 |
| phone |
string |
是 |
联系电话 |
| province |
string |
是 |
省份 |
| city |
string |
是 |
城市 |
| country |
string |
是 |
区县 |
| address_info |
string |
是 |
详细地址 |
| postcode |
string |
是 |
邮编 |
响应头
此接口仅涉及公共响应头。更多信息,请参见公共请求头(Common Request Headers)。
返回参数
| 字段名 |
类型 |
说明 |
| code |
int |
错误码 |
| msg |
string |
错误原因说明 |
| data |
object |
订单信息 |
data 结果参数
| 字段名 |
类型 |
说明 |
| id |
int |
订单ID |
| order_id |
string |
订单号 |
| payment_id |
string |
支付流水ID |
| user_id |
int |
用户ID |
| remark |
string |
订单备注 |
| type |
string |
订单类型 |
| origin_amount |
int |
订单原始总价 |
| amount |
int |
订单实际总价 |
| paid_time |
int |
支付时间 |
| end_time |
int |
订单预计自动完成时间 |
| deliver_time |
int |
发货时间 |
| finished_time |
int |
订单完成时间 |
| discount_amount |
int |
优惠金额 |
| seller_id |
int |
卖家ID |
| seller_amount |
int |
卖家可得收益 |
| share_user_id |
int |
推广者ID |
| share_parent_user_id |
int |
推广者上级ID |
| share_amount |
int |
推广者可得收益 |
| share_parent_amount |
int |
推广者上级可得收益 |
| express_company |
string |
快递公司 |
| tracking_number |
string |
快递运单号 |
| created_time |
int |
下单时间戳 |
| updated_time |
int |
更新时间戳 |
| status |
int |
订单状态:-1取消,0待付款,1已付款,2已发货,3已完成,8退款中,9已退款 |
| refund_status |
int |
退款状态:-1退款失败,0无或退款中,1已退款 |
使用示例
请求示例(单个商品)
POST /api/order/create HTTP/1.1
Host: www.anqicms.com
Content-Type: application/json
{
"goods_id": 188,
"quantity": 1,
"type": "goods",
"remark": "普通商品订单"
}
请求示例(多个商品)
POST /api/order/create HTTP/1.1
Host: www.anqicms.com
Content-Type: application/json
{
"details": [
{
"goods_id": 188,
"quantity": 1
},
{
"goods_id": 189,
"quantity": 2
}
],
"type": "goods",
"address": {
"name": "王先生",
"phone": "13888888888",
"province": "河南省",
"city": "郑州市",
"country": "中原区",
"address_info": "中原西路233号",
"postcode": "450000"
},
"remark": "多商品订单",
"coupon_code": "COUPON2023"
}
响应示例
{
"code": 0,
"msg": "",
"data": {
"id": 46,
"created_time": 1669212548,
"updated_time": 1669212548,
"order_id": "202211232209080046",
"payment_id": "",
"user_id": 1000,
"address_id": 0,
"remark": "普通商品订单",
"type": "goods",
"status": 0,
"refund_status": 0,
"origin_amount": 9900,
"amount": 9900,
"paid_time": 0,
"end_time": 0,
"deliver_time": 0,
"finished_time": 0,
"discount_amount": 0,
"seller_id": 15,
"seller_amount": 7920,
"share_user_id": 0,
"share_parent_user_id": 0,
"share_amount": 0,
"share_parent_amount": 0,
"express_company": "",
"tracking_number": ""
}
}
错误代码
| 错误码 |
说明 |
| 0 |
OK |
| -1 |
错误,错误原因在 msg 中指出 |
| 1001 |
未登录 |
| 1002 |
未授权 |
| 200 |
API 请求 OK |