获取硬件授权结果

POST

https://qyapi.weixin.qq.com/cgi-bin/devicedata/get_auth_info

此接口用于第三方应用获取企业授权的硬件设备列表，后续第三方应用可获取这批设备产生的数据，例如考勤记录、门禁通行记录、测温记录等。

注意：
1.第三方应用须具有“设备接口信息权限”；
2.企业须同时安装硬件设备和第三方应用；
3.企业须向第三方应用二次授权具体硬件设备的原始数据。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/devicedata/get_auth_info' \
--header 'Content-Type: application/json' \
--data-raw '{
	"agentid":1
}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "device_list": {
        "item": [
            {
                "device_sn": "SN",
                "remark_name": "设备备注名",
                "default_name": "设备出厂名",
                "model_name": "PRODUCT_MODEL",
                "device_type": 1,
                "device_ability": 1
            }
        ]
    }
}

请求参数

Query 参数

access_token

string

可选

调用接口凭证。见获取access_token

示例值:

ACCESS_TOKEN

Body 参数application/json

agentid

integer

必需

应用id，仅套件应用需要填写该字段

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

错误码

必需

errmsg

string

错误码描述

必需

device_list

object

必需

授权读取数据的设备列表

item

array [object {6}]

必需

修改于 2022-12-08 02:27:44

概述

获取考勤打卡原始数据