[TOC]
简要描述
获取订单列表接口
请求URL
https://ggtools.thinkerx.com/open-api/orders
请求方式
POST
参数
content_type: application/json
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| app_key | 是 | string | 平台签发key |
| timestamp | 是 | string | 时间戳,精确到秒 |
| account | 是 | string | 平台用户标识 |
| search_value | 否 | string | 模糊搜索订单号、订单地址、客户名称 |
| remark | 否 | string | 使用订单备注搜索订单,支持模糊搜索 |
| page | 否 | integer | 页数,默认为1 |
| limit | 否 | integer | 每页数量,默认为10 |
注意:请求接口时,header中需要携带sign和token,sign生成方式参见 授权说明,token获取方式参见获取用户token接口
返回示例
{
"status": 1,
"msg": "请求成功",
"data": {
"total": 20,
"list": [
{
"id": 1,
"buyer_address": "xx小区1栋1单元",
"order_code": "220101-01",
"create_time": "2022-01-01 08:00:00",
"update_time": "2022-01-01 08:00:00",
"expand_area": "10.00",
"projective_area": "10.00"
},
{
"id": 2,
"buyer_address": "xx小区1栋2单元",
"order_code": "220101-02",
"create_time": "2022-01-01 09:00:00",
"update_time": "2022-01-01 09:00:00",
"expand_area": "20.00",
"projective_area": "20.00"
}
]
}返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| status | integer | 请求状态,1:成功,0:失败 |
| msg | string | 状态说明 |
| data | data_object | 返回数据详情 |
data_object
| 参数名 | 类型 | 说明 |
|---|---|---|
| total | integer | 总共查询到的数量 |
| list | array[order_info_object] | 订单数据 |
order_info_object
| 参数名 | 类型 | 说明 |
|---|---|---|
| id | intger | 订单id |
| buyer_address | string | 订单地址 |
| order_code | string | 订单号 |
| create_time | string | 订单创建时间 |
| update_time | string | 订单修改时间 |
| expand_area | string | 订单展开面积 |
| projective_area | string | 订单投影面积 |
