#

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 }

results matching ""

    No results matching ""