2.14查询通行记录列表

2.14.1应用场景

第三方平台根据调用接口查询通行记录列表。

2.14.2请求链接

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

2.14.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
–startdate String 32 开始日期(yyyy-MM-dd) 2025-01-01。注:开始日期和结束日期不能跨月
–effdate String 32 结束日期(yyyy-MM-dd) 2025-01-01。注:开始日期和结束日期不能跨月
–deptno String 32 部门编号 完整编号,精确查找
–peopleno String 32 人员编号 完整编号,精确查找
–peoplename String 32 人员姓名 关键词,模糊匹配
–deviceno String 32 设备编号 完整编号,精确查找
–group Int 11 识别分组 1-陌生人识别,0-白名单识别,10-访客
–mode Int 11 识别方式 0-智能识别,1-人证模式,2-人卡模式,3-一键开门,6-访客二维码开门,7-密码开门,11-远程开门

2.14.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 记录编号
– deviceno string 设备编号
– peopleno string 人员编号
– peoplename string 人员姓名
– jobnumber string 工号
– photo string 通行记录抓拍图片 阿里云在线url
– iccard string IC卡号
– group string 识别分组 1-陌生人识别,0-白名单识别,10-访客
– mode string 识别方式 0-智能识别,1-人证模式,2-人卡模式,3-一键开门,6-访客二维码开门,7-密码开门,11-远程开门
– addtime string 通行时间 yyyy-MM-dd HH:mm:ss
– outintype string 出入类型 1-入口,0-出口
– exceptionmode string 通行状态 1-正常通行,其他-禁止通行

返回成功

{
"resultcode":"1",
"msg":"获取列表成功",
"appid":"2201140459374",
"timestamp":"20220330142506052",
"data":"
{"total":79,"totalPage":4,"data":[
{"no":"1749198341167","deviceno":"220114020314C","peopleno":"1749196804978384","peoplename":"张浩","jobnumber":"1026322","photo":"http://arkcloud-pass-test.oss-cn-shenzhen.aliyuncs.com/e73862d6-e9de-4787-8b09-c8b9db9e92f6_20250606162541707_4588.jpg?OSSAccessKeyId=LTAIKypdJuYEjfhe&Expires=1756974342&Signature=eB1OEGZMCKgm5%2BD13pJAIWFkfXw%3D","iccard":"","group":"0","mode":"0","addtime":"2025-06-06 16:25:41","outintype":"0","exceptionmode":"1"},
{"no":"1749197455166","deviceno":"220114020314C","peopleno":"1749196804978384","peoplename":"张浩","jobnumber":"1026322","photo":"http://arkcloud-pass-test.oss-cn-shenzhen.aliyuncs.com/75f1c150-0963-431d-94ca-fdc9c306f51c_20250606161055099_4588.jpg?OSSAccessKeyId=LTAIKypdJuYEjfhe&Expires=1756973483&Signature=TVmYt86x%2FiYgnnp5nUG%2Fh7wdafg%3D","iccard":"","group":"0","mode":"0","addtime":"2025-06-06 16:10:55","outintype":"0","exceptionmode":"1"}]
}",
"sign":"7cc62da13e3c91bc8b7a07706d6a5243"
}

返回失败

{
"resultcode":"0",
"msg":"获取列表失败",
"appid":"2201140459374",
"timestamp":"20220330142506052",
"data":"",
"sign":"7cc62da13e3c91bc8b7a07706d6a5243"
}
作者:邻好互联  创建时间:2025-06-19 16:11
最后编辑:邻好互联  更新时间:2025-06-19 18:09