创建订单接口

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

    注意事项

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