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