#
API清单(版本:0.5.3)
编号 | API名称 | 请求路径 | 请求方法 | 版本 |
---|---|---|---|---|
1 | 设备统计数据 | /v1/iot/parkinglot/iot-park/device/statisticsDevice | POST | v1.0.0 |
2 | 车辆统计数据 | /v1/iot/parkinglot/iot-carowner/owner-info/car-info/statisticsCar | POST | v1.0.0 |
3 | 临停统计数据 | /v1/iot/parkinglot/iot-payment/temp/statisticsTemp | POST | v1.0.0 |
4 | 车位统计数据 | /v1/iot/parkinglot/iot-park/car-place/statisticsCarPlace | POST | v1.0.0 |
5 | 车位入伙数据 | /v1/iot/main/customer/join | POST | v1.0.0 |
6 | 车位过户数据 | /v1/iot/main/customer/transfer | POST | v1.0.0 |
7 | 出租数据 | /v1/iot/main/space/lease/batch/saveOrUpdate | POST | v1.0.0 |
8 | 查询历史出租数据 | /v1/iot/main/space/lease/page/{pageNo}/{pageSize} | POST | v1.0.0 |
9 | 查询车位类型 | /v1/iot/main/spaceparkdetail/getSpaceParkNatures | POST | v1.0.0 |
1.设备统计数据
请求路径
- POST /v1/iot/parkinglot/iot-park/device/statisticsDevice
请求参数
字段 | 是否必须 | 字段类型 | 描述 | 备注 |
---|---|---|---|---|
project_id | Y | String | 项目id | |
parkinglot_id | 否 | String | 车场id |
返回参数
字段 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
status | true | int | HTTP状态码 |
code | true | string | 错误码,000000表示请求成功 |
msg | true | string | 提示内容 |
data | false | string | 返回数据 |
device_sum | true | int | 设备数 |
online_device_sum | true | int | 在线设备数 |
offline_device_sum | true | int | 离线设备数 |
alarm_device_sum | true | int | 报警设备数 |
示例:
{ "project_id": 21906, "parkinglot_id": 21933 }
返回结果:
{ "code": "000000", "msg": "请求成功", "data": { "device_sum": 2, "online_device_sum": 0, "offline_device_sum": 2, "alarm_device_sum": 0 }, "status": 200 }
2.车辆统计数据
请求路径
- POST /v1/iot/parkinglot/iot-carowner/owner-info/car-info/statisticsCar
请求参数
字段 | 是否必须 | 字段类型 | 描述 | 备注 |
---|---|---|---|---|
project_id | Y | String | 项目id | 项目id车场id不能同时为空 |
返回参数
字段 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
status | true | int | HTTP状态码 |
code | true | string | 错误码,000000表示请求成功 |
msg | true | string | 提示内容 |
data | false | string | 返回数据 |
new_energys | true | int | 新能源车辆数 |
normals | true | int | 燃油车数 |
approvals | true | int | 待审核车辆数 |
totals | true | int | 车辆总数 |
示例:
{ "project_id": 21906 }
返回结果:
{ "code": "000000", "msg": "请求成功", "data": { "new_energys": 1, "normals": 310, "approvals": 0, "totals": 311 }, "status": 200 }
3.临停统计数据
请求路径
- POST /v1/iot/parkinglot/iot-payment/temp/statisticsTemp
请求参数
字段 | 是否必须 | 字段类型 | 描述 | 备注 |
---|---|---|---|---|
project_id | Y | String | 项目id | |
parkinglot_id | 否 | String | 车场id |
返回参数
字段 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
status | true | int | HTTP状态码 |
code | true | string | 错误码,000000表示请求成功 |
msg | true | string | 提示内容 |
data | false | string | 返回数据 |
begin_day | true | Date | 今日开始时间 |
begin_week | true | Date | 本周开始时间 |
begin_month | true | Date | 本月开始时间 |
today_incomes | true | int | 今日收入(单位:分) |
week_incomes | true | int | 本周收入(单位:分) |
month_incomes | true | int | 本月收入(单位:分) |
示例:
{ "project_id":"21906", "parkinglot_id":"21933" }
返回结果:
{ "code": "000000", "msg": "请求成功", "data": { "begin_day": "2022-06-23T16:00:00.000Z", "begin_week": "2022-06-19T16:00:00.000Z", "begin_month": "2022-05-31T16:00:00.000Z", "today_incomes": 0, "week_incomes": 0, "month_incomes": 126 }, "status": 200 }
4.车位统计数据
请求路径
- POST /v1/iot/parkinglot/iot-park/car-place/statisticsCarPlace
请求参数
字段 | 是否必须 | 字段类型 | 描述 | 备注 |
---|---|---|---|---|
project_id | Y | String | 项目id | |
parkinglot_id | 否 | String | 车场id |
返回参数
字段 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
status | true | int | HTTP状态码 |
code | true | string | 错误码,000000表示请求成功 |
msg | true | string | 提示内容 |
data | false | string | 返回数据 |
temps | true | int | 临时车位 |
rights | true | int | 产权车位 |
rents | true | int | 可租车位 |
rentTypes | true | int | 可租车位状态 |
renteds | true | int | 已租车位 |
rentedTypes | true | int | 已租车位状态 |
solds | true | int | 可售车位 |
soldTypes | true | int | 可售车位状态 |
soldeds | true | int | 已售车位 |
soldedTypes | true | int | 已售车位状态 |
unSoldRents | true | int | 未销售未出租 |
unSoldRentTypes | true | int | 未销售未出租状态 |
totals | true | int | 总车位 |
1-已售,2-未销售未出租,3-未销售已出租,4-未售空置,5-已收楼已入住,6-已售空置-未到收楼日期,7-已售空置--已到收楼日期,8-已租,9-空置,10-其他示例:
{ "project_id":"21906", "parkinglot_id":"21933" }
返回结果:
{ "code": "000000", "msg": "请求成功", "data": { "begin_day": "2022-06-23T16:00:00.000Z", "begin_week": "2022-06-19T16:00:00.000Z", "begin_month": "2022-05-31T16:00:00.000Z", "today_incomes": 0, "week_incomes": 0, "month_incomes": 126 }, "status": 200 }
5.车位入伙
请求路径
- POST /v1/iot/main/customer/join
请求参数
字段 | 是否必须 | 字段类型 | 描述 | |
---|---|---|---|---|
msgId | Y | String | 请求消息id | |
space_id | Y | int | 空间ID(原接口是house_id 房间入伙记得也要改成space_id) | |
list | Y | String | 入伙内容 | |
customer_id | Y | int | 以前怎么给值现在就怎么给 | |
join_date | Y | String | 以前怎么给值现在就怎么给 | |
join_status | N | 以前怎么给值现在就怎么给 | ||
disabled | N | String | 以前怎么给值现在就怎么给 | |
selectDisabled | N | String | 以前怎么给值现在就怎么给 |
返回参数
字段 | 是否必须 | 字段类型 | 描述 | 备注 |
---|---|---|---|---|
key | true | value | 返回内容与原接口一致 |
入参示例 { "msgId": "814b653c-2026-b40e-b0e4-373982047c26", "space_id": 264060, "list": [ { "space_id": 264060, "customer_id": 267378, "notify_date": null, "join_date": "2022-05-18", "join_status": 1, "disabled": false, "selectDisabled": false } ] }
返回结果:
{ "code": "200", "data": { "result": [ { "create_by": "路人甲2", "update_by": "路人甲2", "create_by_id": "21771", "update_by_id": "21771", "create_time": 1656560942000, "update_time": 1656567198310, "id": 267480, "type": 2, "space_id": 264060, "space_code": "100001027100000006100000000100000001100000000", "space_name": "CJ001车", "full_space_name": "领贤公馆/车场/领贤捷顺车场/车场区域/CJ001车", "community_name": "领贤公馆", "community_id": 21906, "community_code": "100001027", "customer_id": 267378, "customer_type": 2, "main_flag": 1, "housing_status": 1000, "customer_name": "张君宝", "customer_phone": "13978478323", "hasAuthRecord": false, "needReturnZoneCount": false, "approved": false, "join_date": "2022-05-18", "identity_type": 1, "identity": "334455200012122090" } ] }, "message": "成功" }
6.车位过户
请求路径
- POST /v1/iot/main/customer/transfer
请求参数
字段 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
msgId | Y | String | 请求消息id |
space_id | Y | int | 原接口是house_id 房间过户记得也要改成space_id |
list | Y | String | 过户内容 |
customer_id | Y | int | 以前怎么给值现在就怎么给 |
transfer_date | Y | String | 以前怎么给值现在就怎么给 |
join_status | N | 以前怎么给值现在就怎么给 |
返回参数
字段 | 是否必须 | 字段类型 | 描述 | 备注 |
---|---|---|---|---|
key | true | value | 返回内容与原接口一致 |
入参示例 { "msgId": "278c1c8a-49e3-c651-6dbf-1dc0d730194d", "list": [ { "house_id": "", "customer_id": 263790, "transfer_date": "2022-06-30", "join_status": 1 } ], "space_id": 264060 }
返回结果: { "code": "200", "message": "成功" }
7.车位出租
请求路径
- POST /v1/iot/main/space/lease/batch/saveOrUpdate
以前是 /v1/iot/main/house/lease/batch/saveOrUpdate -> house改成space,房间出租记得也要修改
请求参数
字段 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
msgId | Y | String | 请求消息id |
space_id | Y | int | 空间ID(原接口是house_id 房间过户记得也要改成space_id) |
list | Y | String | 出租内容 |
attachment | N | String | 以前怎么给值现在就怎么给 |
attachmentM | N | 以前怎么给值现在就怎么给 | |
customer_id | Y | int | 以前怎么给值现在就怎么给 |
type | Y | int | 新增属性(1-房间 2-车位)原房间出租记得加一下) |
disabled | N | 以前怎么给值现在就怎么给 | |
end_time | Y | 以前怎么给值现在就怎么给 | |
space_id | Y | int | 以前给house_id现在传 space_id,房间出租记得也要修改 |
lease_status | Y | int | |
pickerOptionsEnd | N | 以前怎么给值现在就怎么给 | |
pickerOptionsStart | N | ||
remark | N | ||
selectDisabled | N | ||
start_time | N |
返回参数
字段 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
key | true | value | 返回内容与原接口一致 |
入参示例 { "msgId": "f1322159-8e82-17ac-ebbb-a739de3e9e52", "list": [ { "space_id": 264127, "customer_id": 267285, "start_time": "2022-07-01", "end_time": "2022-07-31", "lease_status": 1, "remark": "", "attachmentM": [], "disabled": false, "selectDisabled": false, "pickerOptionsEnd": {}, "pickerOptionsStart": {}, "attachment": "" } ] } 返回示例: { "code": 200, "data": null, "message": "success" }
8.车位出租记录
请求路径
- POST /v1/iot/main/space/lease/page/{pageNo}/{pageSize} 以前是 /v1/iot/main/house/lease/page/{pageNo}/{pageSize} -> house改成space,房间出租记得也要修改
请求参数
字段 | 是否必须 | 字段类型 | 描述 | 备注 |
---|---|---|---|---|
msgId | Y | String | 请求消息id | |
space_id | Y | int | 空间id(原接口是house_id 房间过户记得也要改成space_id) | |
lease_status | Y | int | 出租状态(1-已出租 2-未出租) |
返回参数
字段 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
key | true | value | 返回内容与原接口一致 |
入参示例 { "msgId": "704d0c4b-c813-16f3-f0d3-b76327b10e65", "space_id": 91087, "lease_status": 2 } 返回示例: { "code": 200, "data": null, "message": "success" }
9.车位类型接口
请求路径
- POST /v1/iot/main/spaceparkdetail/getSpaceParkNatures
请求参数
字段 | 是否必须 | 字段类型 | 描述 | |
---|---|---|---|---|
msgId | Y | String | 请求消息id | |
spaceIds | Y | [1,2,3] | 空间id数组 |
返回参数
字段 | 是否必须 | 字段类型 | 描述 |
---|---|---|---|
status | true | int | HTTP状态码 |
message | true | string | 错误码,000000表示请求成功 |
result | true | [] | 返回数据 |
park_nature | true | int | 车位类型(1、临时车位 2、固定车位 3、产权车位) |
space_id | true | int | 空间id |
park_no | true | String | 车位编号 |
入参示例 [21695,21935] 返回示例: { "code": "200", "message": "成功", "version": null, "returnExceptionData": false, "result": [ { "park_nature": 3, "space_id": 21695, "park_no": "003" }, { "park_nature": 3, "space_id": 21935, "park_no": "002888" } ], "data": null }