5.1查询历史订单（车主平台到泊链）

## 一、接口信息

- **测试环境接口地址**：https://beta.bolink.club/unionapi/neworder/queryorders
- **正式环境接口地址**：https://s.bolink.club/unionapi/neworder/queryorders
- **接口方向**：车主平台 → 泊链
- **用途**：车主平台调用 5.1 接口向泊链发送请求，查询车主某个车牌的历史订单信息，泊链返回给车主平台查询结果。

## 二、请求格式

### 请求字段

| 名称 | 类型 | 说明 | 是否必传 | 示例 |
| --- | --- | --- | --- | --- |
| union_id | Number | 厂商平台账户编号 | 是 | 联盟编号，如：109010 |
| order_id | String | 订单编号 | 否 | 填写时只返回匹配的一条订单 |
| plate_number | String | 车牌号码 | 否 | 填写时只返回匹配的所有订单 |
| start_time | Number | 查询开始时间，最多可查 180 天内的订单 | 否 | 默认为当天开始时间 |
| end_time | Number | 查询结束时间 | 否 | 默认为当前时间 |
| page | Number | 查询页码 | 否 | 默认第 1 页 |
| size | Number | 每次返回查询记录数 | 否 | 默认 20 条，最大 100 条 |
| rand | String | 随机数，32 位以内整数或小数，与上次请求不能重复，否则认为是非法请求 | 是 | 0.99993232345436 |

### 请求示例

```json
{
  "order_id": 109010,
  "union_id": 109010,
  "rand": "0.0689257123595276",
  "sign": "82A4EA10F60AEE4172AE4F3C774156EB"
}
```

## 三、同步返回格式

### 返回字段

| 名称 | 类型 | 说明 | 是否必传 | 示例 |
| --- | --- | --- | --- | --- |
| count | Number | 数量，理论上是一条，如果存在出场没有结算掉的订单，就会有多条 | 是 | 1 |
| page | Number | 页码 | 是 | 1 |
| state | number | 返回状态：0 失败，1 成功 | 是 | 1 |
| errmsg | String | 提示信息，查询错误时提示 | state=0 时有值 | 签名错误 |
| data | Json 数组 | 返回数据，下列字段是数组元素 | 是 | [{},{}...] |
| plate_number | String | 车牌号码 | 是 | 苏K88909 |
| start_time | Number | 进场时间（unix 时间戳格式，到秒） | 是 | 1484369702，为 2017-01-14 12:55:02 |
| end_time | number | 出场时间（unix 时间戳格式，到秒） | 是 | 1484369702，为 2017-01-14 12:55:02 |
| money | String | 金额（单位：元） | 是 | 1.50 |
| union_name | String | 车场所属厂商平台 | 是 | 停车宝 |
| park_name | String | 车场名称 | 是 | 海淀区上地三街停车场 |
| trade_no | String | 电子交易单号 | 是，电子支付时有值 | 201703221642522000021002200001 |

### 返回示例

```json
{
  "count": 20,
  "page": 1,
  "state": 1,
  "errmsg": "查询成功",
  "data": [
    {
      "plate_number": "苏K88909",
      "start_time": 1484369702,
      "end_time": 1484369702,
      "money": "1.50",
      "union_name": "停车宝",
      "park_name": "海淀区上地三街停车场"
    }
  ]
}
```

## 四、注意事项

1. `union_id` 为厂商平台账户编号，是必传字段。
2. `order_id` 和 `plate_number` 均为非必传，填写 `order_id` 时只返回匹配的一条订单，填写 `plate_number` 时只返回匹配的所有订单。
3. `start_time`、`end_time` 均为 Unix 时间戳格式，精确到秒；最多可查询 180 天内的订单，默认查询当天开始时间到当前时间。
4. `page` 默认为第 1 页，`size` 默认为 20 条，最大 100 条。
5. `rand` 为随机数，32 位以内整数或小数，与上次请求不能重复，否则认为是非法请求。
6. 返回字段中 `state` 为数字类型：`0` 表示失败，`1` 表示成功；`errmsg` 在 `state=0` 时有值。
7. `count` 理论上是一条，如果存在出场没有结算掉的订单，就会有多条。
8. `data` 为 JSON 数组，数组元素包含 `plate_number`、`start_time`、`end_time`、`money`、`union_name`、`park_name`、`trade_no` 等字段。
9. `trade_no` 在电子支付时有值。
10. 请求示例中 `sign` 为签名值，实际对接时需按泊链签名规则生成。
11. 示例中的中文引号（如 `"苏K88909"` 中的 `"`）为文档格式问题，实际传输时应使用标准英文双引号。