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