第三方应用开发 服务端API 智慧硬件 接口调用 获取硬件授权结果
获取硬件授权结果
最后更新:2022/10/25
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取硬件授权结果
最后更新:2022/10/25

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

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

 

请求方式:POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/devicedata/get_auth_info?access_token=ACCESS_TOKEN

请求包体:

{
	"agentid":1
}

参数说明:

参数名是否必须类型描述
access_tokenstring调用接口凭证。见获取access_token
agentiduint32应用id,仅套件应用需要填写该字段

 

返回结果:

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

参数说明:

参数名描述
errcode错误码
errmsg错误码描述
device_list授权读取数据的设备列表
device_list.item.SN设备SN
device_list.item.remark_name企业设置的备注名称
device_list.item.default_name设备出厂时的名称
device_list.item.model_name设备出厂时的型号
device_list.item.device_type设备类型:1-考勤/门禁设备
device_list.item.device_ability设备能力:
1-具备考勤能力;
2-具备门禁能力;
4-具备测温能力;
设备能力字段可叠加,例如:返回5表示设备具备考勤和测温能力
上一篇
已支持设备
下一篇
获取考勤打卡原始数据