1 相关外围接口
1.1 解锁车接口:
http://arch.smartmideazy.com/apidoc/iot-parking/iot-park.html
1.2 访客接口
http://47.111.56.94/apidoc/door/open-visitor.html
1.3 微信公众号授权
车位预约
https://iot.remacsmart.com/wx/wechat/appoint/110
预约记录:
https://iot.remacsmart.com/wx/car/history/110
一键锁车:
https://iot.remacsmart.com/wx/car/lock/110
一键解锁:
https://iot.remacsmart.com/wx/car/unlock/110
1.4 全局约定
code为200代表成功,非200代表失败
{"code":"200", "message": "成功" ,"result": {...} }
{"code":"10009", "message": "失败"}
域名:iot.remacsmart.com
除 【2.1 公众号车位预约】接口外, 所有的请求需要头部带Token
示例如下:
{"wechatTokenInfo": token值}
token值从【2.1 公众号车位预约】中的用户确认授权后并且服务器正常后的跳转结果中取。即 index.html?token=TOKEN 中的TOKEN值。前端注意保存。
https://biz-admin-sit.smartmideazy.com/v1/iot/door/doorVisitor/insert/marketing
{"openId":"o6Cx46ISmbJ1oWL8-_KS7YWev7RQ","name":"鹏哥","phone":"13926003676","plateCode":"粤X24U98","effectiveTime":"2021-02-23 12:00","expiredTime":"2021-02-23 23:59:59","projectId":"110","visitingManName":"姜山"}
2 接口
2.1 公众号车位预约
URL: https://iot.remacsmart.com/wx/wechat/appoint/{space_id}
Method: POST
body: 空
路径参数:
字段 | 字段类型 | 是否必填 | 说明 |
---|---|---|---|
space_id | Int | 是 | 空间ID(车场ID) |
用户在微信公众号菜单中点击以上URL后,会要求授权公众号访问用户的信息。用户确认授权后直接重定向至前端服务器的主页,并携带相关参数
假设前端的首页访问路径为:https://iot.remacsmart.com/appoint/index.html
若用户确认授权后并且服务器正常,跳转结果如下:
https://iot.remacsmart.com/appoint/index.html?version=1613809174604-release&token=eyJhbGciOiJIUzI1NiJ9.eyJrZXlfbWVtYmVyX2xvZ2luIjoie1wib3BlbmlkXCI6XCJvNkN4NDZJU21iSjFvV0w4LV9LUzdZV2V2N1JRXCIsXCJuaWNrbmFtZVwiOlwi6bmP5ZOlXCIsXCJjaXR5XCI6XCLlub_lt55cIixcInByb3ZpbmNlXCI6XCLlub_kuJxcIixcImNvdW50cnlcIjpcIuS4reWbvVwiLFwiaGVhZGltZ3VybFwiOlwiaHR0cHM6Ly90aGlyZHd4LnFsb2dvLmNuL21tb3Blbi92aV8zMi9Ia1VpYmVjSG1qV0lwWXRHWkFxME0zVGJVRlhpYkxrVnlINkFHeGliUVQxNGtFNklJTTR3SDBpYzl3NTR6d3o2QTZEV29NMjFZWXBZaGVEcXdsa2J3WnlLd0EvMTMyXCIsXCJzZXhcIjoxLFwibGFuZ3VhZ2VcIjpcInpoX0NOXCIsXCJwcml2aWxlZ2VcIjpbXSxcImF1dGhlbl90eXBlXCI6XCJ3ZWNoYXRcIixcImJ1c2luZXNzX3R5cGVcIjpcImFwcG9pbnRcIn0iLCJleHAiOjE2MTM4MTYzNzQsImlhdCI6MTYxMzgwOTE3NCwianRpIjoiYjlmNGYwMTctZjRjMy00YjM2LWIzNmUtOTEwZDljOTMzNzMzIn0.XfnWlVqE2bvkkLq6YgfsSmCqfz_iUmQs6i75NtTXwpo
参数说明:
version : 一个版本标识,可以有助清理html页面缓存。
token: 微信用户数据的加密值。由服务器端根据key来解码。前端在后续接口调用中需要在http头部携带,约定格式如下:
{"wechatTokenInfo": token值}
token有效期为2小时。
若出现错误,跳转结果如下:
https://iot.remacsmart.com/appoint/index.html?error=服务器异常
2.2 车位预约表单保存
URL: https://iot.remacsmart.com/wx/wechat/appoint/save
Method: POST
Header: {"wechatTokenInfo": token值}
body: JSON
Body参数:
字段 | 字段类型 | 是否必填 | 说明 |
---|---|---|---|
name | String | 是 | 预约人姓名 |
mobile | String | 是 | 预约人的手机号 |
car_brand | String | 是 | 车牌号 |
start_time | String | 是,预约起始时间 | 2020-02-20 13:00 |
respondent | String | 否 | 置业顾问姓名 |
返回:
{"code":"200", "message":"成功"}
2.3 车辆进场离场推送
URL: https://iot.remacsmart.com/wx/car/records
Method: POST
Header: {"token": "私下约定"}
body: JSON
JSON参数
字段 | 字段类型 | 是否必填 | 说明 |
---|---|---|---|
car_plate_no | String | 是 | 车牌号 |
time | String | 是 | yyyy-MM-dd HH:mm:ss 进场/离场时间 |
type | String | 是 | 1:进场, 2:离场 |
park_id | String | 是 | 项目ID |
返回:
{"code":"200", "message":"成功"}
2.4 车位预留记录
URL: https://iot.remacsmart.com/wx/car/histories
Method: POST
Body: 空
Header: {"wechatTokenInfo": token值 }
返回:
List
Object参数
字段 | 字段类型 | 是否必返 | 说明 |
---|---|---|---|
name | String | 是 | 姓名 |
car_brand | String | 是 | 车牌 |
mobile | String | 是 | 手机 |
start_time | String | 是 | 开始时间 |
end_time | String | 是 | 结束时间 |
update_time | String | 是 | 提交时间 |
status | int | 是 | 1:解锁状态,2:锁定状态 |
appoint_day | String | 是 | yyyy-MM-dd 格式,预约的日期 |
respondent | String | 是 | 受访人 |
in_out | Int | 是 | 1:预约未进场2:已进场3:已出场 |
car_in_time | String | 是 | 车辆进场时间 yyyy-MM-dd HH:mm:ss |
car_out_time | String | 是 | 车辆出场时间 yyyy-MM-dd HH:mm:ss |
open_id | String | 是 | 微信openId |
lock_time | String | 是 | 车辆进场时间 yyyy-MM-dd HH:mm:ss |
unlock_time | String | 是 | 车辆出场时间 yyyy-MM-dd HH:mm:ss |
返回:
{"code":"200", "message":"成功", "result": [{Object}, ....]}
2.5 车辆锁定
URL: https://iot.remacsmart.com/wx/car/lock
Method: POST
Body: JSON
Header: {"Authorization": token值 }
BODY 字段约定:
字段 | 字段类型 | 是否必填 | 说明 |
---|---|---|---|
car_brand | String | 是 | 车牌 |
appoint_day | String | 是 | 预约日期 yyyy-MM-dd |
返回:
{"code":"200", "message":"成功"}
2.6 车辆解锁
URL: https://iot.remacsmart.com/wx/car/unlock
Method: POST
Body: JSON
Header: {"wechatTokenInfo": token值 }
BODY 字段约定:
字段 | 字段类型 | 是否必返 | 说明 |
---|---|---|---|
car_brand | String | 是 | 车牌 |
appoint_day | String | 是 | 预约日期 |
lock_log_id | String | 是 | 锁定车辆后返回的记录ID |
返回:
{"code":"200", "message":"成功"}