2.4查询访客列表

2.4.1应用场景

第三方平台根据条件查询访客信息列表。（注：请求频率小于60次/分钟）

2.1.2.请求链接

URL地址：http://服务器地址/api/v2/visitor/getlist

2.4.3请求参数

字段 类型 长度 必填 描述 示例值
companyno string 32 是 企业编号 e41e0f04d13e4196
appid string 32 是 第三方应用appid 123456789
timestamp string 32 是 时间戳字符串 20200701161800123
sign string 50 是 签名字符串 同社区接口签名一致
data string 是 参数，必须是正确的json字符串
格式，并且经过AES加密		 详情见参数示例
–pageindex Int 11 是 当前页数 1
–pagesize Int 11 是 每页显示数量 20
–visitorname String 32 否 访客名称 关键词，模糊匹配
–visitorphone String 32 否 手机号码 完整号码，精确查找
–carno String 32 否 访客车牌号 关键词，模糊匹配
–visitoridcard String 32 否 证件号码 完整号码，精确查找
–visitortype int 11 否 访客类型 0=平台，1=公众号，2=小程序，3=台式访客机，4=立式访客机，6=访客登记客户端，5=其他

2.4.4返回结果

字段 类型 描述 示例值
resultcode string 结果状态 1成功，0失败
msg string 结果信息
appid string 第三方应用appid e41e0f04d13e4196
timestamp string 时间戳字符串 20200701161800123
sign string 签名字符串 同社区接口签名一致
data string 参数，必须是正确的json字符串格式，并且经过
AES加密		 详情见参数示例
– total Int 总数量
– totalPage int 总页数
– data string 人员信息列表
– no string 访客编号 8684859109528267
– name string 访客姓名 对接
– jobnumber string 被访人工号 800001
– peoplename string 被访人姓名 张三
– sex string 性别 男、女、未知
– phone string 手机号码
– photo string 人员头像图片 阿里云在线url
– carno string 车牌号
– idCard string 证件号
– type string 登记类型 0=平台，1=公众号，2=小程序，3=台式访客机，4=立式访客机，6=访客登记客户端，5=其他
– addtime string 添加时间

返回成功

{
"resultcode":"1",
"msg":"获取列表成功",
"appid":"2201140459374",
"timestamp":"20220330142506052",
"data":"
{"total":115,"totalPage":6,"data":[{"no":"8684859109528267","name":"对接","jobnumber":"800001","peoplename":"张三","sex":"未知","phone":"13465995597","carno":"","photo":"http://arkcloud-test.oss-cn-shenzhen.aliyuncs.com/web/1748591094728413.jpeg?Expires=4904264694&OSSAccessKeyId=LTAIKypdJuYEjfhe&Signature=%2BykUY%2F5O2FAiXCSW6RDDqobipVY%3D","idcard":"8684859109528267","type":"1","addtime":"2025-05-30 15:44:55"},{"no":"8684858509310752","name":"李师师","sex":"男","phone":"13462959966","carno":"","photo":"http://arkcloud-test.oss-cn-shenzhen.aliyuncs.com/web/1748566661959986.jpeg?Expires=4904240261&OSSAccessKeyId=LTAIKypdJuYEjfhe&Signature=0ALdv9kZZsrYAPGzmVfFdDNuYNg%3D","idcard":"","type":"1","addtime":"2025-05-30 14:05:21"}]}",
"sign":"7cc62da13e3c91bc8b7a07706d6a5243"
}

返回失败

{
"resultcode":"0",
"msg":"获取列表失败",
"appid":"2201140459374",
"timestamp":"20220330142506052",
"data":"",
"sign":"7cc62da13e3c91bc8b7a07706d6a5243"
}
作者：张浩  创建时间：2025-06-30 15:06
最后编辑：潘诗标  更新时间：2026-09-22 16:20