创建订单接口

创建用户购物订单,支持单个商品或多个商品下单,可指定收货地址、优惠券等信息。

注意事项

  • 该接口采用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