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
最后编辑:邻好互联  更新时间:2026-06-30 09:13