智慧硬件开发 硬件云端接入 设备接入 接口调用 获取设备中指定成员的信息
获取设备中指定成员的信息
最后更新:2023/06/01
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取设备中指定成员的信息
最后更新:2023/06/01

根据open_userid获取设备可用范围内的指定成员的信息。

 

请求方式:POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/openhw/device/get_userinfo_by_ids?device_access_token=DEVICE_ACCESS_TOKEN
请求包体:

{
	"user_item":[
		{"open_userid":"ww***********", "user_type":0},
		{"open_userid":"*w***x********", "user_type":2}
	]
}

参数说明:

参数名是否必须类型描述
device_access_tokenstringdevice_access_token ,获取方式见获取设备型号调用凭证
user_itemarray(object)获取成员的id列表,最多100条
user_item.open_useridstring获取成员的open_userid
user_item.user_typeuint32成员类型:0-企业成员;2-学生

 

返回结果:

{
    "errcode":0,
    "errmsg":"ok",
    "userinfo":{
        "useritems":[
            {
                "open_userid":"ww***********",
                "user_name":"张三",
                "user_type":1,
                "pass_rule":{
                    "rule_list":[
                        {
                            "id":0,
                            "rule":"9:00-10:00 * * 1-5 *",
                            "effect_time":1542874137
                        },
                        {
                            "id":1,
                            "rule":"9:30-10:00 * * 6 *",
                            "effect_time":1542874137
                        }
                    ]
                }
            },
            {
                "open_userid":"*w***x********",
                "user_name":"李四",
                "user_type":2,
                "pass_rule":{
                    "rule_list":[
                        {
                            "id":0,
                            "rule":"9:00-10:00 * * 1-6 *",
                            "effect_time":1542874137
                        }
                    ]
                }
            }
        ]
    }
}

参数说明:

参数名描述
errcode错误码
errmsg错误码描述
userinfo.useritems.open_userid成员open_userid
userinfo.useritems.user_name成员userid
userinfo.useritems.user_type成员类型:0-企业成员;2-学生
userinfo.useritems.pass_rule放行规则列表,id为编号,rule为具体规则,其解析语法请参考附录门禁放行规则语法说明
上一篇
全量获取设备成员列表
下一篇
上报设备固件升级结果