交易订单汇总信息查询

接口地址: /open-api/trade/order/getOrderSummary

请求方式: POST

接口描述: 根据查询时间和手机号,统计用户的订单数量和总金额

公共请求参数:

参数名称参数说明请求类型是否必须数据类型示例值
appId应用IDheadertruestringtest
nonce随机字符串headertruestring75ba4a58-8db0-4ce0-b403-2ccc8dbaea72
timestamp时间戳headertruestring1772763315016
sign签名串headertruestring89f4ad32ea7151cc33477215c24e8020bfb801a9a805a1369d9d6ceddc67a7e4

业务请求参数

参数名称参数说明请求类型是否必须数据类型示例值
userMobile用户手机号bodytruestring13660000000
startTime开始时间bodyfalsestring2024-01-01 00:00:00
endTime结束时间bodyfalsestring2024-12-31 23:59:59

请求示例

  1. POST /open-api/trade/order/getOrderSummary HTTP/1.1
  2. Host: fjgs-gateway.imageco.cn
  3. Content-Type: application/json
  4. appId: test
  5. nonce: 75ba4a58-8db0-4ce0-b403-2ccc8dbaea72
  6. timestamp: 1746677123456
  7. sign: xxxxxxxxxxxxxxxxxxxx
  8. {
  9. "userMobile": "13660000000",
  10. "startTime": "2025-01-01 00:00:00",
  11. "endTime": "2025-12-31 23:59:59"
  12. }

响应参数:

参数名称参数说明类型示例值
code返回码integer0
msg返回信息string
data业务数据JSONObject参考data业务数据

data 业务数据 (JSONObject)

参数名称参数说明类型示例值
orderCount订单数量long15
totalAmount订单总金额(分)long158000

响应示例:

  1. { "code": 0, "msg": "", "data": { "orderCount": 15, "totalAmount": 158000 } }

备注:

  • totalAmount 单位为分,如需转换为元,请除以 100
  • 如果不传 startTimeendTime,则统计该用户的所有订单
  • 时间格式必须为:yyyy-MM-dd HH:mm:ss