检查UserId合法性 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

智慧硬件开发

快速入门硬件直连接入硬件云端接入更新日志联系我们

智慧硬件开发硬件直连接入考勤/门禁设备接口调用检查UserId合法性

检查UserId合法性

最后更新：2022/09/16

检查userid是否在设备的使用范围内

请求包体：

{
	"cmd":"check_userid",
	"headers":
	{
		"req_id":"xxxxx"
	},
	"body":
	{
		"userid": ["zhangsan", "lisi", "wangwu"],   //老版本用
		"userid_item": [                           //新版本用
			{ "userid":"zhangsan", "user_type":0 },
			{ "userid":"lisi", "user_type":2 }
		]
	}

}

参数说明：

参数名	是否必须	类型	描述
req_id	是	String	请求的id，自行保证不会重复即可
userid	老版本是	array	员工id，单次请求最多200个
userid_item	新版本是	array(object)	userid、user_type数据结构，成员的类型： 0：企业员工 1：访客 2：学生不填默认为0

返回结果：

{
	"headers": {
		"req_id": "xxxx"
	},
	"body":{
		//老版本用
		"legal_userid":["zhangsan"],
		"illegal_userid":["lisi", "wangwu"]
		//新版本用
		"legal_userid_item":[
			{ "userid":"zhangsan" , "user_type":0 }, 
			{ "userid":"lisi" , "user_type":2 }],
        "illegal_userid_item":[
			{ "userid":"zhangsan" , "user_type":0 }, 
			{ "userid":"lisi" , "user_type":2 }]
	},
	"errcode": 0,
	"errmsg": "ok"
}

参数说明：

参数名	类型	描述
req_id	String	透传请求的req_id
legal_userid	array	合法的userid列表
illegal_userid	array	不合法的userid列表
userid_item	array(object)	userid、user_type数据结构，成员的类型： 0：企业员工 1：访客 2：学生不填默认为0

增量获取用户数据

获取UserId的变更信息

本节内容

检查UserId合法性