访客车辆授权管理

API列表

请求方式	API	描述
POST	/v1.0/iot-02/third/parking/visitor-cars	新增访客车
PUT	/v1.0/iot-02/third/parking/visitor-cars/{auth_record_id}/extend	访客车时间续期
DELETE	/v1.0/iot-02/third/parking/visitor-cars/{auth_record_id}	删除访客车
GET	/v1.0/iot-02/third/parking/visitor-cars	访客车辆分页查询

新增访客车

功能描述

新增访客车

接口地址

POST /v1.0/iot-02/third/parking/visitor-cars

请求参数

参数名	类型	参数类型	说明	是否必需
gateway_id	String	body	网关 id	true
plate_number	String	body	车牌号	true
visitor_name	String	body	访客姓名	false
interviewee_name	String	body	被访者姓名	false
start_time	long	body	开始时间	true
end_time	long	body	结束时间	true
remark	String	body	内容	false

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	String	访客车 id

请求示例

POST /v1.0/iot-02/third/parking/visitor-cars
{
  "gateway_id": "i9OPH3ht6q",
  "plate_number": "浙A12345",
  "visitor_name": "张三",
  "interviewee_name": "李四",
  "start_time": 182855,
  "end_time": 796040,
  "remark": "3RSEuRzAdz"
}

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": "8LVzjElR79"
}

访客车时间续期

功能描述

访客车时间续期

接口地址

PUT /v1.0/iot-02/third/parking/visitor-cars/{auth_record_id}/extend

请求参数

参数名	类型	参数类型	说明	是否必需
auth_record_id	String	url	授权 id	true
gateway_id	String	body	网关 id	true
start_time	long	body	开始时间	true
end_time	long	body	结束时间	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	boolean	成功、失败

请求示例

PUT /v1.0/iot-02/third/parking/visitor-cars/{auth_record_id}/extend
{
  "gateway_id": "h7iE3x2kXT",
  "start_time": 703494,
  "end_time": 470889
}

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": false
}

删除访客车

功能描述

删除访客车

接口地址

DELETE /v1.0/iot-02/third/parking/visitor-cars/{auth_record_id}

请求参数

参数名	类型	参数类型	说明	是否必需
auth_record_id	String	url	授权 id	true
gateway_id	String	query	网关 id	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	boolean	成功、失败

请求示例

DELETE /v1.0/iot-02/third/parking/visitor-cars/{auth_record_id}?gateway_id=CWp1LA99VS

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": true
}

访客车辆分页查询

功能描述

访客车辆分页查询

接口地址

GET /v1.0/iot-02/third/parking/visitor-cars

请求参数

参数名	类型	参数类型	说明	是否必需
page_no	int	query	页码，最小值 1	false
page_size	int	query	页大小，最小值 1，最大值 1000	false
gateway_id	String	query	网关 id	false
auth_record_id	String	query	授权 id	false
str_plate_numbers	String	query	车牌号集合	false

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	Object	访客车信息分页列表

result 参数说明

参数名	类型	说明
total	int	总数
data	Object[]	当前页数据
- project_id	String	项目 id
- creator	String	创建者
- modifier	String	修改者
- gmt_create	long	创建时间（毫秒）
- gmt_modified	long	修改时间（毫秒）
- auth_record_id	String	授权记录 id
- plate_number	String	车牌号
- visitor_name	String	访客姓名
- interviewee_name	String	被访者姓名
- start_time	long	开始时间
- end_time	long	结束时间
- remark	String	内容

请求示例

GET /v1.0/iot-02/third/parking/visitor-cars?page_no=1&page_size=100&gateway_id=ytLSuudKck&auth_record_id=GpXKKUQiMW&str_plate_numbers=4gG3KQX6fz

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": {
    "total": 1,
    "data": [
      {
        "project_id": "EDtOlE9oSg",
        "creator": "bJIiV3XiSk",
        "modifier": "cdZlNCHhOa",
        "gmt_create": 907195,
        "gmt_modified": 706280,
        "auth_record_id": "HI2uHbVSxi",
        "plate_number": "ivhfR3NTS1",
        "visitor_name": "iMaREHijqg",
        "interviewee_name": "5JhrDpn3vd",
        "start_time": 363992,
        "end_time": 127827,
        "remark": "ubvItIdp3a"
      }
    ]
  }
}