订单查询

根据订单号和平台信息查询订单详情，适用于订单履约、客服查询和对账场景。

POST https://api.cheeli.com/open/v1/orders/query 在线调试

请求参数

参数名称	类型	必填	说明
order_id	string	是	平台订单号
platform	string	是	平台标识，如 taobao、jd、pdd
shop_id	string	是	店铺 ID

请求示例

Request json

{
  "order_id": "202603100001",
  "platform": "taobao",
  "shop_id": "shop_10001"
}

返回参数

字段名称	类型	必填	说明
order_id	string	是	订单号
status	string	是	订单状态
buyer_name	string	否	买家姓名
amount	integer	是	订单金额，单位分
created_at	string	是	创建时间

返回示例

Response json

{
  "code": 0,
  "message": "success",
  "data": {
    "order_id": "202603100001",
    "status": "WAIT_SHIP",
    "buyer_name": "张三",
    "amount": 19900,
    "created_at": "2026-03-10T10:30:00+08:00"
  }
}

错误码

错误码	错误标识	说明
40001	InvalidParameter	请求参数缺失或格式错误
40004	OrderNotFound	订单不存在
50000	InternalError	系统内部错误

SDK 示例

Java

Java java

CheeliClient client = new CheeliClient("your_app_key", "your_app_secret");
OrderQueryRequest request = new OrderQueryRequest();
request.setOrderId("202603100001");
OrderQueryResponse response = client.orders().query(request);

Go

Go go

client := cheeli.NewClient("your_app_key", "your_app_secret")
resp, err := client.Orders.Query(ctx, &cheeli.OrderQueryRequest{
    OrderID: "202603100001",
})