以下为与订单操作相关的接口文档,包含创建、查询及更新订单功能:
创建订单
使用
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
:已完成
扩展阅读:订单管理规范