访客管理
访客申请是指访客在到访前,由业务或物业填写访客信息,再验证的流程。
1.1 新增访客申请
Path路径 | /solution/community/house/visitor/apply/add |
请求方式 | post |
接口版本 | 1.0.0 |
请求参数
参数 | 类型 | 必填 | 描述 |
houseId | String | 是 | 房屋ID |
startTime | String | 是 | 到访时间 格式:yyyy-MM-dd HH:mm:ss |
endTime | String | 是 | 结束时间 格式:yyyy-MM-dd HH:mm:ss |
visitors | JSONArray | 是 | 访客列表 |
--name | String | 是 | 姓名 |
--type | String | 是 | 身份类型:1业主本人,2亲属,3租客,4朋友,5同事,6装修人员,7保姆,8司机,9其它 |
--idCard | String | 否 | 身份证号 |
--phone | String | 否 | 手机号 |
--gender | Integer | 否 | 性别 |
--plateNum | String | 否 | 车牌 |
返回参数
参数 | 类型 | 描述 |
data | JSONArray | |
--applyId | String | 访问申请ID |
1.2 作废访客申请
Path路径 | /solution/community/house/visitor/apply/cancel |
请求方式 | post |
接口版本 | 1.0.0 |
请求参数
参数 | 类型 | 必填 | 描述 |
applyId | String | 是 | 访问申请ID |
返回参数
参数 | 类型 | 描述 |
无 |
1.3 人工访客核销
Path路径 | /solution/community/house/visitor/apply/confirm |
请求方式 | post |
接口版本 | 1.0.0 |
请求参数
参数 | 类型 | 必填 | 描述 |
applyId | String | 是 | 访问申请ID |
返回参数
参数 | 类型 | 描述 |
无 |
1.4 查询访客详情
根据访客申请的ID查询访客详情
Path路径 | /solution/community/house/visitor/apply/get |
请求方式 | post |
接口版本 | 1.0.0 |
请求参数
参数 | 类型 | 必填 | 描述 |
applyId | String | 否 | 访客用户ID |
返回参数
参数 | 类型 | 描述 |
data | JSON | 访客数据 |
访客数据
字段名 | 类型 | 备注 |
applyId | String | 申请ID |
name | String | 姓名 |
communityName | String | 小区名 |
houseName | String | 房屋名 |
type | Integer | 访客类型 |
phone | String | 手机号(脱敏) |
idCard | String | 身份证号(脱敏) |
identityId | String | 提交者身份Id |
visitorId | String | 访客身份ID |
gender | Integer | 性别 |
plateNum | String | 车牌 |
startTime | String | 到访时间 |
endTime | String | 结束时间 |
checkStatus | Integer | 验证状态0未到访,1已到访,2废弃 |
1.5 批量查询访客
Path路径 | /solution/community/house/visitor/apply/query |
请求方式 | post |
接口版本 | 1.0.0 |
请求参数
参数 | 类型 | 必填 | 描述 |
startTime | String | 是 | 开始时间 |
endTime | String | 是 | 结束时间 |
houseId | String | 否 | 房屋ID |
pageNo | Integer | 是 | 页号 |
pageSize | Integer | 是 | 页大小 |
返回参数
参数 | 类型 | 描述 |
pageNo | Integer | 页号 |
pageSize | Integer | 页大小 |
total | Integer | 总数据量 |
data | JSONArray | 访客数据列表 |
访客数据
字段名 | 类型 | 备注 |
applyId | String | 申请ID |
name | String | 姓名 |
communityName | String | 小区名 |
houseName | String | 房屋名 |
type | Integer | 访客类型 |
phone | String | 手机号(脱敏) |
idCard | String | 身份证号(脱敏) |
identityId | String | 提交者身份id |
gender | Integer | 性别 |
plateNum | String | 车牌 |
startTime | String | 到访时间 |
endTime | String | 结束时间 |
checkStatus | Integer | 验证状态0未到访,1已到访,2废弃 |