• 權(quán)限說明

管理員須擁有“操作通訊錄”的接口權(quán)限，以及指定部門的管理權(quán)限。

• 返回結(jié)果

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

?我們?cè)贑#里面，需要定義對(duì)應(yīng)給的接口，然后根據(jù)需要構(gòu)造對(duì)應(yīng)的傳遞實(shí)體信息。

這里我把人員管理的接口全部定義好，接口定義如下所示。

????????#region?部門成員管理????????///?<summary>
????????///?創(chuàng)建成員????????///?</summary>
????????CommonResult?CreateUser(string?accessToken,?CorpUserJson?user);????????///?<summary>
????????///?更新成員????????///?</summary>
????????CommonResult?UpdateUser(string?accessToken,?CorpUserUpdateJson?user);????????///?<summary>
????????///?刪除成員????????///?</summary>
????????CommonResult?DeleteUser(string?accessToken,?string?userid);????????///?<summary>
????????///?根據(jù)成員id獲取成員信息????????///?</summary>
????????CorpUserGetJson?GetUser(string?accessToken,?string?userid);????????///?<summary>
????????///?獲取部門成員????????///?</summary>
????????CorpUserListJson?GetDeptUser(string?accessToken,?int?department_id,?int?fetch_child?=?0,?int?status?=?0);????????#endregion

然后根據(jù)信息定義，創(chuàng)建一個(gè)承載人員信息的CorpUserJson實(shí)體對(duì)象，創(chuàng)建人員的實(shí)現(xiàn)操作代碼如下所示。

????????///?<summary>
????????///?創(chuàng)建成員????????///?</summary>
????????public?CommonResult?CreateUser(string?accessToken,?CorpUserJson?user)
????????{????????????string?urlFormat?=?"http://ipnx.cn/{0}";????????????var?data?=?new
????????????{
????????????????userid?=?user.userid,
????????????????name?=?user.name,
????????????????department?=?user.department,
????????????????position?=?user.position,
????????????????mobile?=?user.mobile,
????????????????gender?=?user.gender,
????????????????tel?=?user.tel,
????????????????email?=?user.email,
????????????????weixinid?=?user.weixinid
????????????};????????????var?url?=?string.Format(urlFormat,?accessToken);????????????var?postData?=?data.ToJson();????????????return?Helper.GetCorpExecuteResult(url,?postData);
????????}

?

2、成員的更新操作

成員的數(shù)據(jù)更新和創(chuàng)建操作類似，它的企業(yè)號(hào)定義如下所示。

• 請(qǐng)求說明

Https請(qǐng)求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/user/update?access_token=ACCESS_TOKEN

請(qǐng)求包示例如下（如果非必須的字段未指定，則不更新該字段之前的設(shè)置值）:

{
???"userid":?"zhangsan",
???"name":?"李四",
???"department":?[1],
???"position":?"后臺(tái)工程師",
???"mobile":?"15913215421",
???"gender":?1,
???"tel":?"62394",
???"email":?"zhangsan@gzdev.com",
???"weixinid":?"lisifordev",
???"enable":?1
}

由于它的操作數(shù)據(jù)類似，因此它的實(shí)現(xiàn)代碼也差不多，如下所示就是。

????????///?<summary>
????????///?更新成員????????///?</summary>
????????public?CommonResult?UpdateUser(string?accessToken,?CorpUserUpdateJson?user)
????????{????????????string?urlFormat?=?"http://ipnx.cn/{0}";????????????//string?postData?=?user.ToJson();
????????????var?data?=?new
????????????{
????????????????userid?=?user.userid,
????????????????name?=?user.name,
????????????????department?=?user.department,
????????????????position?=?user.position,
????????????????mobile?=?user.mobile,
????????????????gender?=?user.gender,
????????????????tel?=?user.tel,
????????????????email?=?user.email,
????????????????weixinid?=?user.weixinid,
????????????????enable?=?user.enable
????????????};????????????var?url?=?string.Format(urlFormat,?accessToken);????????????var?postData?=?data.ToJson();????????????return?Helper.GetCorpExecuteResult(url,?postData);
????????}

?

3、成員的刪除、成員的獲取、部門成員的獲取操作

這些操作和上面的類似，不在贅述，主要就是根據(jù)需要定義他們對(duì)應(yīng)的返回?cái)?shù)據(jù)信息，然后解析Json數(shù)據(jù)即可轉(zhuǎn)換為對(duì)應(yīng)的實(shí)體。

1）刪除人員的定義如下：

• 請(qǐng)求說明

Https請(qǐng)求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/user/delete?access_token=ACCESS_TOKEN&userid=lisi

• 參數(shù)說明

• 返回結(jié)果

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

2）成員的獲取定義如下：

• 請(qǐng)求說明

Https請(qǐng)求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&userid=lisi

• 參數(shù)說明

• 返回結(jié)果

{
???"errcode":?0,
???"errmsg":?"ok",
???"userid":?"zhangsan",
???"name":?"李四",
???"department":?[1,?2],
???"position":?"后臺(tái)工程師",
???"mobile":?"15913215421",
???"gender":?1,
???"tel":?"62394",
???"email":?"zhangsan@gzdev.com",
???"weixinid":?"lisifordev",??
???"avatar":?"http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0",
???"status":?1
}

3）部門成員的獲取定義如下：

• 請(qǐng)求說明

Https請(qǐng)求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token=ACCESS_TOKEN&department_id=1&fetch_child=0&status=0

• 參數(shù)說明

• 權(quán)限說明

管理員須擁有’獲取部門成員’的接口權(quán)限，以及指定部門的查看權(quán)限。

• 返回結(jié)果

{
???"errcode":?0,
???"errmsg":?"ok",
???"userlist":?[
???????????{
??????????????????"userid":?"zhangsan",
??????????????????"name":?"李四"
???????????}
?????]
}

這個(gè)返回值我們定義一個(gè)實(shí)體對(duì)象用來存儲(chǔ)數(shù)據(jù)即可。

????///?<summary>
????///?獲取部門成員返回的數(shù)據(jù)????///?</summary>
????public?class?CorpUserListJson?:?BaseJsonResult
????{????????public?CorpUserListJson()
????????{????????????this.userlist?=?new?List<corpusersimplejson>();
????????}????????///?<summary>
????????///?返回的錯(cuò)誤消息????????///?</summary>
????????public?CorpReturnCode?errcode?{?get;?set;?}????????///?<summary>
????????///?對(duì)返回碼的文本描述內(nèi)容????????///?</summary>
????????public?string?errmsg?{?get;?set;?}????????///?<summary>
????????///?成員列表????????///?</summary>
????????public?List<corpusersimplejson>?userlist?{?get;?set;?}
????}</corpusersimplejson></corpusersimplejson>

?

7、綜合例子調(diào)用代碼

上面介紹了一些企業(yè)號(hào)的接口定義和我對(duì)API的C#封裝接口和部分實(shí)現(xiàn)代碼，實(shí)現(xiàn)了功能后，我們就可以在代碼中對(duì)它進(jìn)行測(cè)試，確信是否正常使用。

????????///?<summary>
????????///?人員管理綜合性操作（創(chuàng)建、修改、獲取信息、刪除）????????///?</summary>
????????///?<param>
????????///?<param>
????????private?void?btnCorpUser_Click(object?sender,?EventArgs?e)
????????{
????????????CorpUserJson?user?=?new?CorpUserJson();
????????????user.userid?=?"test";
????????????user.name?="測(cè)試用戶";
????????????user.department?=?new?List<int>(){2};
????????????user.email?=?"test@163.com";

????????????ICorpAddressBookApi?bll?=?new?CorpAddressBookApi();
????????????CommonResult?result?=?bll.CreateUser(token,?user);????????????if?(result?!=?null)
????????????{
????????????????Console.WriteLine("創(chuàng)建成員:{0}?{1}?{2}",?user.name,?(result.Success???"成功"?:?"失敗"),?result.ErrorMessage);????????????????string?name?=?"修改測(cè)試";
????????????????user.name?=?name;
????????????????CorpUserUpdateJson?userUpdate?=?new?CorpUserUpdateJson(user);
????????????????result?=?bll.UpdateUser(token,?userUpdate);????????????????if?(result?!=?null)
????????????????{
????????????????????Console.WriteLine("修改名稱:{0}?{1}?{2}",?name,?(result.Success???"成功"?:?"失敗"),?result.ErrorMessage);
????????????????}

????????????????CorpUserGetJson?userGet?=?bll.GetUser(token,?user.userid);????????????????if?(userGet?!=?null)
????????????????{
????????????????????Console.WriteLine("成員名稱:{0}?({1}?{2})",?userGet.name,?user.userid,?user.email);
????????????????}

????????????????result?=?bll.DeleteUser(token,?user.userid);????????????????if?(result?!=?null)
????????????????{
????????????????????Console.WriteLine("刪除成員:{0}?{1}?{2}",?name,?(result.Success???"成功"?:?"失敗"),?result.ErrorMessage);
????????????????}
????????????}
????????}</int>

獲取部門人員的操作代碼如下所示。

????????///?<summary>
????????///?獲取部門人員????????///?</summary>
????????private?void?btnCorpUserList_Click(object?sender,?EventArgs?e)
????????{????????????int?deptId?=?1;
????????????ICorpAddressBookApi?bll?=?new?CorpAddressBookApi();
????????????CorpUserListJson?result?=?bll.GetDeptUser(token,?deptId);????????????if?(result?!=?null)
????????????{????????????????foreach(CorpUserSimpleJson?item?in?result.userlist)
????????????????{
????????????????????Console.WriteLine("成員名稱:{0}?{1}",?item.name,?item.userid);
????????????????}
????????????}
????????}

?

更多C#開發(fā)微信入口網(wǎng)站及應(yīng)用-微信企業(yè)號(hào)的通訊錄管理開發(fā)之成員管理相關(guān)文章請(qǐng)關(guān)注PHP中文網(wǎng)！