1、根据条件查询访客登记列表
1.1、应用场景
第三方平台根据条件查询访客登记信息列表。(注:请求频率小于60次/分钟)
1.2、接口链接
URL地址:http://服务器地址/api/open/Visitor/GetVisitorList
1.3、请求参数
字段 | 类型 | 长度 | 必填 | 描述 | 示例值 |
---|---|---|---|---|---|
appId | string | 32 | 是 | 平台应用appid | pm65b0195c12225a37 |
companyNo | string | 32 | 是 | 企业编码 | 2005181057489971 |
timesTamp | string | 32 | 是 | 时间戳字符串 | 20200701161800123 |
sign | string | 50 | 是 | 签名字符串 | 详情见签名介绍 |
data | string | 是 | 必须是正确的json字符串格式,数据AES加密处理 | 详情见参数示例 | |
– pageIndex | string | 是 | 当前页数 | 默认1 | |
– pageSize | string | 是 | 每页显示数量 | 默认20,最大50 | |
– visitorName | string | 100 | 否 | 访客名称 | |
– visitorPhone | string | 100 | 否 | 完整访客手机号 | |
– visitoridCard | string | 100 | 否 | 完整访客证件号 | |
– carNo | string | 100 | 否 | 车牌号 | |
–visitorType | string | 10 | 否 | 登记类型 | 0-平台,1-公众号,2-小程序,3-台式访客机,4-立式访客机,5-其他 |
1.4、参数示例
{
"appId": "pm65b0195c12225a37",
"companyNo": "2006152039393448",
"data": "{“visitorName”:“访客名称”}",
"sign": "",
"timesTamp": "20190109140653904"
}
1.5、响应参数
字段 | 类型 | 长度 | 必填 | 描述 | 示例值 |
---|---|---|---|---|---|
resultCode | string | 是 | 1-请求成功,其他-请求失败 | 1 | |
appId | string | 32 | 是 | 平台应用appid | pm65b0195c12225a37 |
msg | string | 请求失败时返回的消息 | |||
data | string | 响应参数数据包,正确的json字符串格式 | |||
– count | string | 总页数 | |||
–data | string | 内容集合 | |||
—- visitorNo | string | 访客编码 | |||
—- visitorName | string | 访客姓名 | |||
—- visitorSex | string | 访客性别 | 0-未知 1-男 2-女 | ||
—- visitorPhone | string | 访客手机号 | |||
—- visitoridCardPhoto | string | 身份证照片 | |||
—- visitorPhoto | string | 照片 | |||
—- visitorCarNo | string | 车牌号 | |||
—- visitoridCard | string | 身份证号 | |||
—- peopleName | string | 被访人名称 | |||
—- departmentName | string | 被访人部门编码 | |||
—- checkedOutTime | string | 签离时间 | 允许为空,yyyy-MM-dd HH:mm:ss | ||
—- visitorType | string | 登记类型 | 登记方式:0-平台,1-公众号,2-小程序,3-台式访客机,4-立式访客机,5-其他 | ||
—- visitorStatus | string | 访客状态 | 审核状态:0-未审核,1-已拒绝,2-已审核;3-已到访;4-已签离 |
1.6、请求成功响应参数示例
{
"resultCode": "1", //1:成功,其它:失败
"appId": "1", //应用ID
"data": "{"total":"10","data":"[{
"visitorName":"",//访客姓名
}]"}", //data数据加密处理,详情请看AES加密
"msg": "查询成功"
}
1.7、请求失败响应参数示例
{
"resultCode": "0",
"appId": "pm65b0195c12225a37",
"data": "",
"msg": "查询异常"
}
作者:ppt 创建时间:2024-10-29 20:08
最后编辑:ppt 更新时间:2024-10-30 10:52
最后编辑:ppt 更新时间:2024-10-30 10:52