/ 
QQ-exmail-1.10
River stage zero No dependents
/ QQ::exmail::user

Name

QQ::exmail::user

DESCRIPTION

通讯录管理->管理成员

FUNCTION

create(access_token, hash);

创建成员

SYNOPSIS

https://exmail.qq.com/qy_mng_logic/doc#10014

请求说明：

请求包结构体为：

{
   	"userid": "zhangsan@gzdev.com",
   	"name": "张三",
   	"department": [1, 2],
   	"position": "产品经理",
   	"mobile": "15913215XXX",
   	"tel": "123456",
   	"extid": "01",
   	"gender": "1",
　 	"slaves": ["zhangsan@gz.com", "zhangsan@bjdev.com"],
	"password":"******",
	"cpwd_login":0
}

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证
userid	        是	成员UserID。企业邮帐号名，邮箱格式
name	        是	成员名称。长度为1~64个字节
department	    是	成员所属部门id列表，不超过20个
position	    否	职位信息。长度为0~64个字节
mobile	        否	手机号码
tel	            否	座机号码
extid	        否	编号
gender	        否	性别。1表示男性，2表示女性
slaves	        否	别名列表
                    1.Slaves 上限为5个
                    2.Slaves 为邮箱格式
password	    是	英文和数字
cpwd_login	    否	用户重新登录时是否重设密码, 登陆重设密码后，该标志位还原。0表示否，1表示是，缺省为0

权限说明

系统应用须拥有指定部门的管理权限。

RETURN 返回结果

{
   "errcode": 0,
   "errmsg": "created"
}

RETURN 参数说明

参数	    说明
errcode	返回码
errmsg	对返回码的文本描述内容

update(access_token, hash);

更新成员

SYNOPSIS

https://exmail.qq.com/qy_mng_logic/doc#10015

请求说明：

请求包示例如下（如果非必须的字段未指定，则不更新该字段之前的设置值）:

{
   "userid": " zhangsan@gzdev.com ",
   "name": "张三",
   "department": [1, 2],
   "position": "产品经理",
   "mobile": "15913215421",
   "gender": "1",
   "enable": 1,
   "password":"******",
   "cpwd_login":1
}

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证
userid	        是	成员UserID。企业邮帐号名，邮箱格式
name	        否	成员名称。长度为0~64个字节
department	    否	成员所属部门id列表，不超过20个
position	    否	职位信息。长度为0~64个字节
mobile	        否	手机号码
tel	            否	座机号码
extid	        否	编号
gender	        否	性别。1表示男性，2表示女性
slaves	        否	别名列表
                    1.Slaves 上限为5个
                    2.Slaves 为邮箱格式
enable	        否	启用/禁用成员。1表示启用成员，0表示禁用成员
password	    否	密码
cpwd_login	    否	用户重新登录时是否重设密码, 登陆重设密码后，该标志位还原。0表示否，1表示是，缺省为0

权限说明

系统应用须拥有指定部门、成员的管理权限。

RETURN 返回结果

{
   "errcode": 0,
   "errmsg": "updated"
}

RETURN 参数说明

参数	    说明
errcode	返回码
errmsg	对返回码的文本描述内容

delete(access_token, userid);

删除成员

SYNOPSIS

https://exmail.qq.com/qy_mng_logic/doc#10016

请求说明：

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证
userid	        是	成员UserID。企业邮帐号名，邮箱格式

权限说明

系统应用须拥有指定成员的管理权限。

RETURN 返回结果

{
   "errcode": 0,
   "errmsg": "deleted"
}

RETURN 参数说明

参数	    说明
errcode	返回码
errmsg	对返回码的文本描述内容

get(access_token, userid);

获取成员

SYNOPSIS

https://exmail.qq.com/qy_mng_logic/doc#10017

请求说明：

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证
userid	        是	成员UserID

权限说明

系统应用须拥有指定成员的查看权限。

RETURN 返回结果

{
   "errcode": 0,
   "errmsg": "ok",
   "userid": " zhangsan@gzdev.com ",
   "name": "李四",
   "department": [1, 2],
   "position": "后台工程师",
   "mobile": "15913215421",
   "gender": "1",
   "enable": 1,
   "slaves":[ zhangsan@gz.com, zhangsan@bjdev.com],
   "cpwd_login":0
}

RETURN 参数说明

参数	        说明
errcode	    返回码
errmsg	    对返回码的文本描述内容
userid	    成员UserID
name	    成员名称
department	成员所属部门id列表
position	职位信息
mobile	    手机号码
tel	        座机号码
extid	    编号
gender	    性别。0表示未定义，1表示男性，2表示女性
enable	    启用/禁用成员。1表示启用成员，0表示禁用成员
slaves	    别名列表
            1、Slaves上限为5个
            2、Slaves为邮箱格式
cpwd_login	用户重新登录时是否重设密码, 登陆重设密码后，该标志位还原。0表示否，1表示是，缺省为0

simplelist(access_token, department_id, fetch_child);

获取部门成员

SYNOPSIS

https://exmail.qq.com/qy_mng_logic/doc#10018

请求说明：

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证
department_id	是	获取的部门id。id为1时可获取根部门下的成员
fetch_child	    否	1/0：是否递归获取子部门下面的成员

权限说明

系统应用须拥有指定部门的查看权限。

RETURN 返回结果

{
	"errcode": 0,
	"errmsg": "ok",
	"userlist": [
        {
        	"userid": "zhangsan@gzdev.com",
        	"name": "李四",
        	"t": [1, 2]
        }
    ]
}

RETURN 参数说明

参数	        说明
errcode	    返回码
errmsg	    对返回码的文本描述内容
userlist	成员列表
userid	    成员UserID
name	    成员名称
department	成员所属部门

list(access_token, department_id, fetch_child);

获取部门成员（详情）

SYNOPSIS

https://exmail.qq.com/qy_mng_logic/doc#10019

请求说明：

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证
department_id	是	获取的部门id。id为1时可获取根部门下的成员
fetch_child	    否	1/0：是否递归获取子部门下面的成员

权限说明

系统应用须拥有指定部门的查看权限。

RETURN 返回结果

{
    "errcode": 0,
    "errmsg": "ok",
    "userlist": [
        {
            "userid": "zhangsan@gzdev.com",
            "name": "李四",
            "department": [1, 2],
            "position": "后台工程师",
            "tel": "60000",
            "mobile": "15913215421",
            "extid": "123456789",
            "gender": "1",
            "enable": "1",
            "slaves": ["zhangsan@gz.com", "zhangsan@bjdev.com"],
            "cpwd_login": 0
        }
    ]
}

RETURN 参数说明

参数	        说明
errcode	    返回码
errmsg	    对返回码的文本描述内容
userlist	成员列表
userid	    成员UserID。企业邮帐号名，邮箱格式
name	    成员名称
department	成员所属部门id列表
position	职位信息
mobile	    手机号码
tel	        座机号码
extid	    编号
gender	    性别。0表示未定义，1表示男性，2表示女性
slaves	    别名列表
            1、Slaves上限为5个
            2、Slaves为邮箱格式
cpwd_login	用户重新登录时是否重设密码, 登陆重设密码后，该标志位还原。0表示否，1表示是，缺省为0。

batchcheck(access_token, hash);

批量检查账号

SYNOPSIS

https://exmail.qq.com/qy_mng_logic/doc#10020

请求说明：

请求包结构体为：

{
	"userlist": ["zhangsan@bjdev.com", "zhangsangroup@shdev.com"]
}

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证
userlist	    是	成员帐号，每次检查不得超过20个

RETURN 返回结果

{
    "errcode": 0,
    "errmsg": "ok",
    "list": [
        {"user":"zhangsan@bjdev.com", "type":1},
        {"user":"zhangsangroup@shdev.com", "type":3}
    ]
}

RETURN 参数说明

参数	    说明
errcode	返回码
errmsg	对返回码的文本描述内容
list	列表数据
user	成员帐号
type	帐号类型。-1:帐号号无效; 0:帐号名未被占用; 1:主帐号; 2:别名帐号; 3:邮件群组帐号