C#開發微信門戶及應用(18)-微信企業號的通訊錄管理開發之成員管理

在上篇隨筆《C#開發微信門戶及應用(17)-微信企業號的通訊錄管理開發之部門管理》介紹了通訊錄的部門的相關操作管理，通訊錄管理包括部門管理、成員管理、標簽管理三個部分，本篇主要介紹成員的管理操作，包括創建、刪除、更新、獲取、獲取部門成員幾個操作要點。

1、成員的創建操作

為了方便，我們可以創建一個部門組織結構，這是開發的前提，因為我們通訊錄管理，也是基于一個組織機構下的，如上篇介紹的組織結構層次一樣。我這里創建一個廣州愛奇迪的根結構，然后在其中在創建一些組織機構，如下圖所示。

在后臺可以通過功能操作添加人員，本篇主要介紹如何調用微信企業號API進行人員管理的操作。

創建人員的API定義如下所示。

• 請求說明

Https請求方式: POST

https://qyapi.weixin.QQ.com/cgi-bin/user/create?access_token=ACCESS_TOKEN

請求包結構體為:

{   "userid": "zhangsan",   "name": "張三",   "department": [1, 2],   "position": "產品經理",   "mobile": "15913215421",   "gender": 1,   "tel": "62394",   "email": "zhangsan@gzdev.com",   "weixinid": "zhangsan4dev"}

• 參數說明

• 權限說明

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

• 返回結果

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

我們在C#里面，需要定義對應給的接口，然后根據需要構造對應的傳遞實體信息。

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

        #region 部門成員管理        /// <summary>        /// 創建成員        /// </summary>        CommonResult CreateUser(string accessToken, CorpUserJson user);        /// <summary>        /// 更新成員        /// </summary>        CommonResult UpdateUser(string accessToken, CorpUserUpdateJson user);        /// <summary>        /// 刪除成員        /// </summary>        CommonResult DeleteUser(string accessToken, string userid);        /// <summary>        /// 根據成員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

然后根據信息定義，創建一個承載人員信息的CorpUserJson實體對象，創建人員的實現操作代碼如下所示。

        /// <summary>        /// 創建成員        /// </summary>        public CommonResult CreateUser(string accessToken, CorpUserJson user)        {            string urlFormat = "https://qyapi.weixin.qq.com/cgi-bin/user/create?access_token={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、成員的更新操作

成員的數據更新和創建操作類似，它的企業號定義如下所示。

• 請求說明

Https請求方式: POST

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

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

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

由于它的操作數據類似，因此它的實現代碼也差不多，如下所示就是。

        /// <summary>        /// 更新成員        /// </summary>        public CommonResult UpdateUser(string accessToken, CorpUserUpdateJson user)        {            string urlFormat = "https://qyapi.weixin.qq.com/cgi-bin/user/update?access_token={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、成員的刪除、成員的獲取、部門成員的獲取操作

這些操作和上面的類似，不在贅述，主要就是根據需要定義他們對應的返回數據信息，然后解析Json數據即可轉換為對應的實體。

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

• 請求說明

Https請求方式: GET

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

• 參數說明

• 返回結果

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

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

• 請求說明

Https請求方式: GET

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

• 參數說明

• 返回結果

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

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

• 請求說明

Https請求方式: GET

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

• 參數說明

• 權限說明

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

• 返回結果

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

這個返回值我們定義一個實體對象用來存儲數據即可。

    /// <summary>    /// 獲取部門成員返回的數據    /// </summary>    public class CorpUserListJson : BaseJsonResult    {        public CorpUserListJson()        {            this.userlist = new List<CorpUserSimpleJson>();        }        /// <summary>        /// 返回的錯誤消息        /// </summary>        public CorPReturnCode errcode { get; set; }        /// <summary>        /// 對返回碼的文本描述內容        /// </summary>        public string errmsg { get; set; }        /// <summary>        /// 成員列表        /// </summary>        public List<CorpUserSimpleJson> userlist { get; set; }    }

7、綜合例子調用代碼

上面介紹了一些企業號的接口定義和我對API的C#封裝接口和部分實現代碼，實現了功能后，我們就可以在代碼中對它進行測試，確信是否正常使用。

        /// <summary>        /// 人員管理綜