获取订单列表

API文档最后更新: 2026-10-28

获取订单列表

通用鉴权、响应、返回字段和错误说明见接入指南。

GET /openapi/v1/admin/orders?page=1&pageSize=20&status=pending

查询参数均可选，多个条件共同生效。

参数

类型

说明

page

integer

页码，默认 1

pageSize

integer

每页条数，默认 10，最大 100

keyword

string

完整的 D 加 17 位数字订单号按单号精确查询，其余按商品名称模糊查询

orderNo

string

订单号模糊查询

externalOrderNo

string

采购方订单号或销售渠道外部订单号模糊查询

status

string

订单状态；空或 all 不限定

productName

string

商品名称模糊查询

orderInput

string

按完整充值输入值查询，例如完整充值账号

productType

string

card、recharge

paymentChannel

string

支付渠道代码，例如 balance；sales_channel 用于销售渠道订单筛选

userId

integer

买家用户 ID，0 表示游客

nickname

string

买家昵称模糊查询

adminRemark

string

管理备注模糊查询

startDate / endDate

string

同时传入起止日期，包含两个日期当天

minAmount / maxAmount

number

实付金额下限、上限

orderType

string

来源分类：platform、partner、supplier、guest、redemption；空或 all 不限定

示例响应：

{
  "code": 0,
  "message": "success",
  "data": {
    "list": [{
      "id": 12345,
      "orderNo": "D26102812345678901",
      "status": "pending",
      "orderType": "local",
      "sourceType": "local",
      "productType": "recharge",
      "goodsId": 101,
      "goodsName": "充值商品",
      "skuId": 0,
      "skuName": "",
      "quantity": 1,
      "salePrice": "10.0000",
      "totalPrice": 10,
      "refundedAmount": 0,
      "paymentChannel": "balance",
      "createdAt": 1793145600,
      "user": {"id": 1000, "nickname": "示例用户", "avatar": "", "isGuest": false}
    }],
    "total": 1,
    "page": 1,
    "pageSize": 20
  },
  "requestId": "req_example"
}

示例展示常用字段，其余条件字段见接入指南的“字段与状态”一节及 YAML。

上一篇下一篇