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
最后编辑:邻好互联 更新时间:2025-06-19 18:09