文档
测试

13.查询历史下单记录

POST
api_method:u-order-list

接口描述

获取账户下历史订单列表

系统级请求参数

参数名
类型
描述
必填
api_method
string
接口方法名。请传“u-order-list”
必填
api_version
string
接口版本号。请传固定值“1.0”
必填
app_key
string
开发者应用唯一app_key
必填
access_token
string
用户账户授权访问令牌
必填
nonce_str
string
随机数,用户自定义,60s内不可重复使用,用于确保请求不可重复
必填
timestamp
number
unix时间戳(单位:秒),时间戳应为60s内的值,超过60s则超时
必填
signature
string
签名值
必填

应用级请求参数(api_data数据结构)

参数名
类型
描述
必填
status_group
int
订单状态分组 1进行中,2已完成,3已取消
可选
order_status
array(int)
订单状态,多个状态可用逗号隔开
可选
order_time_s
long
查询开始时间(unix时间戳),订单用车时间
可选
order_time_e
long
查询结束时间(unix时间戳),订单用车时间
可选
page_no
int
第几页
可选
page_size
int
每页多少条,最多不超过100条
可选

响应参数

参数名
类型
描述
必填
ret
int
返回结果码
必填
msg
string
返回结果描述
必填
data
object
数据字典
必填
record_total
int
总记录条数
必填
page_total
int
总分页数
必填
page_no
int
第几页
必填
page_size
number
每页多少条
必填
order_list
array
订单数据列表
必填
order_display_id
string
订单ID,示例:197693435156
必填
order_time
long
订单用车时间(unix时间戳,单位秒),示例:1584370020
必填
create_time
long
订单创建时间(unix时间戳,单位秒),示例:1584360020
必填
total_price_fen
number
总价格(单位分)
必填
order_status
number
订单状态
必填
order_vehicle_name
string
订单车型名称, 示例:⼩⾯包⻋
必填
addr_info
array
订单地址信息
必填
name
string
地名, 示例:卓悦汇购物中⼼
必填
addr
string
地址详情, 示例:深圳市福⽥区梅康路
必填
lat_lon
object
地址经纬度信息(gcj02坐标系)
必填
lat
double
定位纬度,示例:22.573230423997
必填
lon
double
定位精度,示例:114.05487818175
必填
city_id
number
所属城市ID, 示例:1002
必填
city_name
string
所属城市名称 示例:深圳
必填
district_name
string
所属城市区(县),示例:福⽥区
必填
house_number
string
楼层及门牌号
必填
contacts_name
string
地址联系人
必填
contacts_phone_no
string
地址联系人手机
必填

请求json示例:

```json { "api_method":"u-order-list", "api_version":"1.0", "app_key":"*****************", "access_token":"**********************", "signature":"*******************", "nonce_str":"8sZD2c7raj", "timestamp":1564022849, "api_data":"{ \"status_group\":1, \"order_status\":\"0\", \"order_time_s\":1587635199, \"order_time_e\":1587665199, \"page_no\":1, \"page_size\":20 }" } ```

返回json示例:

```json { "ret":0, "msg":"", "data":{ "record_total":5, "page_total":5, "page_no":1, "page_size":1, "order_list":[ { "order_display_id":"197693435156", "order_time":1584370020, "create_time":1584360020, "total_price_fen":3500, "order_status":2, "order_vehicle_name":"⼩⾯包⻋", "addr_info":[ { "lat_lon":{ "lat":22.573230423997, "lon":114.05487818175 }, "name":"卓悦汇购物中⼼", "addr":"深圳市福⽥区梅康路", "city_id":1002, "district_name":"福⽥区", "house_number":"", "contacts_name":"", "contacts_phone_no":"", "city_name":"" }, { "lat_lon":{ "lat":22.572213402975, "lon":114.05448490823 }, "lat_lon_baidu":{ }, "name":"上梅林", "addr":"上梅林", "city_id":1002, "district_name":"", "house_number":"", "contacts_name":"", "contacts_phone_no":"", "city_name":"" } ] } ] } } ```

返回状态码说明

|ret状态码|描述| |-|-| |0|成功|