以下为与订单操作相关的接口文档,包含创建、查询及更新订单功能:

创建订单

使用 POST /api/order/create 接口可新增订单,需携带以下参数:

参数名 类型 必填 描述
order_id string 订单唯一标识符
items array 商品列表(格式:[{product_id: "123", quantity: 2}]
total_amount number 总金额(单位:元)

示例请求:

POST /api/order/create HTTP/1.1
Content-Type: application/json

{
  "order_id": "ORDER_20231001",
  "items": [{"product_id": "PROD_001", "quantity": 1}],
  "total_amount": 99.99
}

查询订单

通过 GET /api/order/{order_id} 可获取指定订单详情,例如:

订单详情

更新订单状态

调用 PUT /api/order/{order_id}/status 修改订单状态,支持以下状态码:

  • pending:待支付
  • processing:处理中
  • completed:已完成

扩展阅读:订单管理规范