获取门禁通行原始数据

第三方应用获取企业已授权的门禁设备通行记录。

注意：
1.第三方应用须具有“设备接口信息权限-门禁通行原始数据”授权；
2.企业须同时安装硬件设备和第三方应用；
3.企业须向第三方应用二次授权具体硬件设备的原始数据；
4.仅返回应用可见范围内的成员门禁通行数据；
5.接口返回数据按照门禁通行记录上传时间排序；
6.请求时间跨度应在一个月内，并且跨月请求易返回重复数据，请尽量避免；
7.部分场景下，接口可能返回重复的测温数据，调用端应进行排重。

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/devicedata/get_accesscontrol_data' \ --header 'Content-Type: application/json' \ --data-raw '{ "user_type":0, "begin_time":12345, "end_time":67890, "data_filter_type":1, "device_sn_list":[ "SN1", "SN2" ], "open_userid_list":[ ], "cursor":"CURSOR", "limit":"LIMIT", "agentid":10000 }'

{ "errcode": 0, "errmsg": "ok", "accesscontrol_data": { "items": [ { "open_userid": "userid1", "user_type": 0, "timestamp": 1662697304, "pass_type": 1, "pass_method": 0, "device_sn": "C00123122" }, { "open_userid": "userid2", "user_type": 0, "timestamp": 1662697304, "pass_type": 1, "pass_method": 0, "device_sn": "C00123122" } ] }, "next_cursor": "FVXbiWcnRUTZ8ZBzI905eQ==" }

请求参数

Query 参数

access_token

string

应用调用接口权限

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

user_type

integer

必需

成员类型，0-企业成员，2-学生

begin_time

integer

必需

表示设备上传记录的开始时间戳

end_time

integer

必需

表示设备上传记录的结束时间戳，时间跨度不超过一个月

data_filter_type

integer

必需

门禁通行数据筛选条件，1-按设备sn进行筛选，该条件下device_sn_list必填；2-按成员openuserid进行筛选，该条件下open_userid_list必填

device_sn_list

array[string]

可选

门禁设备SN列表，最多传入100个

open_userid_list

array[string]

可选

成员openuserid列表，最多传入100个，须在应用可见范围，否则忽略

cursor

string

可选

分页查询游标，上一次调用时返回的next_cursor，初次调用可以不填。调用方需保证cursor的正确性

limit

string

可选

分页查询限制，最多可返回limit条数据，不填默认200，最多500

agentid

integer

可选

应用agentid，第三方套件应用必填，第三方单应用可不填

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

错误码

必需

errmsg

string

错误码描述

必需

accesscontrol_data

object

门禁通行数据

必需

items

array [object {6}]

必需

next_cursor

string

必需

当前数据最后一个key值，如果下次调用带上该值则从该key值往后拉，用于实现分页拉取，返回空字符串代表已经是最后一页