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://open.weixin.qq.com/connect/qrconnect?appid=&redirect_uri=redirect_uri=https%3a%2f%2fiot.remacsmart.com%2fwx%2fgetOpenId&response_type=code&scope=snsapi_login&state=110$wechat#wechat_redirect

车位预约

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":"成功"}

https://iot.remacsmart.com/appoint/index.html#/pages/record/index?version=1614084720355-release&token=eyJhbGciOiJIUzI1NiJ9.eyJrZXlfbWVtYmVyX2xvZ2luIjoie1wib3BlbmlkXCI6XCJvNkN4NDZJU21iSjFvV0w4LV9LUzdZV2V2N1JRXCIsXCJuaWNrbmFtZVwiOlwi6bmP5ZOlXCIsXCJjaXR5XCI6XCLlub_lt55cIixcInByb3ZpbmNlXCI6XCLlub_kuJxcIixcImNvdW50cnlcIjpcIuS4reWbvVwiLFwiaGVhZGltZ3VybFwiOlwiaHR0cHM6Ly90aGlyZHd4LnFsb2dvLmNuL21tb3Blbi92aV8zMi9Ia1VpYmVjSG1qV0lwWXRHWkFxME0zVGJVRlhpYkxrVnlINkFHeGliUVQxNGtFNklJTTR3SDBpYzl3NTR6d3o2QTZEV29NMjFZWXBZaGVEcXdsa2J3WnlLd0EvMTMyXCIsXCJzZXhcIjoxLFwibGFuZ3VhZ2VcIjpcInpoX0NOXCIsXCJwcml2aWxlZ2VcIjpbXSxcImF1dGhlbl90eXBlXCI6XCJ3ZWNoYXRcIixcImJ1c2luZXNzX3R5cGVcIjpcImFwcG9pbnRsaXN0XCIsXCJzcGFjZV9pZFwiOjExMCxcInNwYWNlX25hbWVcIjpcIue-jueahOaWsOa1t-WyuFwiLFwiYXBwSWRcIjpcInd4YTljMTE5MzBkZTFjZTcwNlwiLFwiYXBwU2VjcmV0XCI6XCI5MjNlNTVjYzcwNzhiOTUyOWQzMmFmNWU3M2Y0Y2QwM1wifSIsImV4cCI6MTYxNDA5MTkyMCwiaWF0IjoxNjE0MDg0NzIwLCJqdGkiOiIzN2EzOGMwZi0wYTQ0LTQwYzMtOTdiMi1mMGVkMWRlODIxMDEifQ.WzIcQsFS9CJ4oXmORmPt6j7SxXqO_9w52nfxb3pvjks

results matching ""

    No results matching ""