日本综合一区二区|亚洲中文天堂综合|日韩欧美自拍一区|男女精品天堂一区|欧美自拍第6页亚洲成人精品一区|亚洲黄色天堂一区二区成人|超碰91偷拍第一页|日韩av夜夜嗨中文字幕|久久蜜综合视频官网|精美人妻一区二区三区

RELATEED CONSULTING
相關(guān)咨詢
選擇下列產(chǎn)品馬上在線溝通
服務(wù)時(shí)間：8:30-17:00
你可能遇到了下面的問題
關(guān)閉右側(cè)工具欄

新聞中心

這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
微信企業(yè)號(hào)的通訊錄管理開發(fā)之部門管理

前面一篇隨筆企業(yè)號(hào)的一些基礎(chǔ)信息，以及介紹如何配置企業(yè)號(hào)的回調(diào)方式實(shí)現(xiàn)和企業(yè)號(hào)服務(wù)器進(jìn)行溝通的橋梁。本篇主要還是繼續(xù)介紹企業(yè)號(hào)的開發(fā)工作的開展，介紹微信企業(yè)號(hào)通訊錄管理開發(fā)功能，介紹其中組織機(jī)構(gòu)里面如何獲取和管理部門的信息等內(nèi)容。

站在用戶的角度思考問題，與客戶深入溝通，找到公主嶺網(wǎng)站設(shè)計(jì)與公主嶺網(wǎng)站推廣的解決方案，憑借多年的經(jīng)驗(yàn)，讓設(shè)計(jì)與互聯(lián)網(wǎng)技術(shù)結(jié)合，創(chuàng)造個(gè)性化、用戶體驗(yàn)好的作品，建站類型包括：網(wǎng)站設(shè)計(jì)制作、成都網(wǎng)站制作、企業(yè)官網(wǎng)、英文網(wǎng)站、手機(jī)端網(wǎng)站、網(wǎng)站推廣、主機(jī)域名、雅安服務(wù)器托管、企業(yè)郵箱。業(yè)務(wù)覆蓋公主嶺地區(qū)。

 1、企業(yè)組織的創(chuàng)建和配置

首先我們可以在企業(yè)號(hào)的管理后臺(tái)里面創(chuàng)建一個(gè)組織機(jī)構(gòu)，里面創(chuàng)建一些部門和人員列表，方便我們開發(fā)和使用。

例如創(chuàng)建一個(gè)廣州愛奇迪的根結(jié)構(gòu)，然后在其中在創(chuàng)建一些組織機(jī)構(gòu)，如下圖所示。

然后給組織結(jié)構(gòu)根節(jié)點(diǎn)“廣州愛奇迪”增加一個(gè)管理員權(quán)限，以后再開發(fā)接口里面也就可以使用這個(gè)管理員所屬的權(quán)限Secret值進(jìn)行調(diào)用了。

CorpID是企業(yè)號(hào)的標(biāo)識(shí)，每個(gè)企業(yè)號(hào)擁有一個(gè)***的CorpID；Secret是管理組憑證密鑰。
系統(tǒng)管理員可通過管理端的權(quán)限管理功能創(chuàng)建管理組，分配管理組對(duì)應(yīng)用、通訊錄、接口的訪問權(quán)限。完成后，管理組即可獲得***的secret。系統(tǒng)管理員可通過權(quán)限管理查看所有管理組的secret，其他管理員可通過設(shè)置中的開發(fā)者憑據(jù)查看。

我的企業(yè)號(hào)的創(chuàng)建者和“廣州愛奇迪”組織結(jié)構(gòu)的管理員是不同的，由于Secret是管理組憑證密鑰，因此管理者負(fù)責(zé)不同的組織機(jī)構(gòu)管理的話，自己的管理Secret值可能就不同了。如果我們需要調(diào)用接口，就需要用到這個(gè)屬于自己權(quán)限級(jí)別的Secret值，如下圖所示。

 如果不是企業(yè)號(hào)的創(chuàng)建者，那么可能不能修改里面的一些權(quán)限分配，只能查看。

2、API訪問的全局***票據(jù)AccessToken的獲取

和公眾號(hào)一樣，我們調(diào)用企業(yè)號(hào)API的***步也是需要先獲取訪問的票據(jù)AccessToken。這個(gè)票據(jù)是全局性的，有一定的時(shí)效和頻率控制，因此需要適當(dāng)?shù)倪M(jìn)行緩存，不能每次調(diào)用都去刷新獲取。

企業(yè)號(hào)獲取訪問票據(jù)的主要的邏輯代碼如下所示，其主要的就是需要使用管理者的Secret值去獲取對(duì)應(yīng)的口令，這樣它就能夠知道管理的是那個(gè)組織結(jié)構(gòu)的了。

 
 
    
  
  
  1. ///   
    2. 
  
  
  2.         /// 獲取每次操作微信API的Token訪問令牌  
    3. 
  
  
  3.         ///   
    4. 
  
  
  4.         /// 企業(yè)Id  
    5. 
  
  
  5.         /// 管理組的憑證密鑰  
    6. 
  
  
  6.         ///   
    7. 
  
  
  7.         public string GetAccessTokenNoCache(string corpid, string corpsecret)  
    8. 
  
  
  8.         {  
    9. 
  
  
  9.             var url = string.Format("https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={0}&corpsecret={1}",  
    10. 
  
  
  10.                                     corpid, corpsecret);  
    11. 
  
  
  11.  
    12. 
  
  
  12.             HttpHelper helper = new HttpHelper();  
    13. 
  
  
  13.             string result = helper.GetHtml(url);  
    14. 
  
  
  14.             string regex = "\"access_token\":\"(?.*?)\"";  
    15. 
  
  
  15.  
    16. 
  
  
  16.             string token = CRegex.GetText(result, regex, "token");  
    17. 
  
  
  17.             return token;  
    18. 
  
  
  18.         } 
    19.

微信企業(yè)號(hào)的說明如下所示：

當(dāng)企業(yè)應(yīng)用調(diào)用企業(yè)號(hào)接口時(shí)，企業(yè)號(hào)后臺(tái)為根據(jù)此次訪問的AccessToken,校驗(yàn)訪問的合法性以及所對(duì)應(yīng)的管理組的管理權(quán)限以返回相應(yīng)的結(jié)果。

注：你應(yīng)該審慎配置管理組的權(quán)限，夠用即好，權(quán)限過大會(huì)增加誤操作可能性及信息安全隱患。

AccessToken是企業(yè)號(hào)的全局***票據(jù)，調(diào)用接口時(shí)需攜帶AccessToken。AccessToken需要用CorpID和Secret來換取，不同的Secret會(huì)返回不同的AccessToken。正常情況下AccessToken有效期為7200秒，有效期內(nèi)重復(fù)獲取返回相同結(jié)果，并自動(dòng)續(xù)期。由于獲取access_token的api調(diào)用次數(shù)非常有限，建議企業(yè)全局存儲(chǔ)與更新access_token，頻繁刷新access_token會(huì)導(dǎo)致api調(diào)用受限，影響自身業(yè)務(wù)。

2、通訊錄管理之部門信息的維護(hù)

有了***節(jié)里面的訪問票據(jù)，我們就可以利用API來做很多事情了，包括組織結(jié)構(gòu)的獲取、創(chuàng)建、刪除等等功能。

創(chuàng)建部門的官方接口定義如下所示。

  • 請(qǐng)求說明

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

https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token=ACCESS_TOKEN

請(qǐng)求包結(jié)構(gòu)體為:

 
 
    
  
  
  1. {  
    2. 
  
  
  2.    "name": "郵箱產(chǎn)品組",  
    3. 
  
  
  3.    "parentid": "1" 
    4. 
  
  
  4. }  
    5.
  • 參數(shù)說明
參數(shù) 必須 說明
access_token是調(diào)用接口憑證
name是部門名稱。長度限制為1~64個(gè)字符
parentid是父親部門id。根部門id為1
  • 返回結(jié)果
 
 
    
  
  
  1. {  
    2. 
  
  
  2.    "errcode": 0,  
    3. 
  
  
  3.    "errmsg": "created",  
    4. 
  
  
  4.    "id": 2  
    5. 
  
  
  5. } 
    6.

根據(jù)上面的一些類似的接口定義說明，我們先來定義下組織機(jī)構(gòu)部門數(shù)據(jù)的維護(hù)接口，然后在逐步實(shí)現(xiàn)和調(diào)用。

 
 
    
  
  
  1. #region 部門管理  
    2. 
  
  
  2.         ///   
    3. 
  
  
  3.         /// 創(chuàng)建部門。  
    4. 
  
  
  4.         /// 管理員須擁有“操作通訊錄”的接口權(quán)限，以及父部門的管理權(quán)限。  
    5. 
  
  
  5.         ///   
    6. 
  
  
  6.         CorpDeptCreateJson CreateDept(string accessToken, string name, string parentId);  
    7. 
  
  
  7.  
    8. 
  
  
  8.         ///   
    9. 
  
  
  9.         /// 更新部門。  
    10. 
  
  
  10.         /// 管理員須擁有“操作通訊錄”的接口權(quán)限，以及該部門的管理權(quán)限。  
    11. 
  
  
  11.         ///   
    12. 
  
  
  12.         CommonResult DeleteDept(string accessToken, int id);  
    13. 
  
  
  13.  
    14. 
  
  
  14.         ///   
    15. 
  
  
  15.         /// 刪除部門.  
    16. 
  
  
  16.         /// 管理員須擁有“操作通訊錄”的接口權(quán)限，以及該部門的管理權(quán)限。  
    17. 
  
  
  17.         ///   
    18. 
  
  
  18.         CorpDeptListJson ListDept(string accessToken);  
    19. 
  
  
  19.  
    20. 
  
  
  20.         ///   
    21. 
  
  
  21.         /// 獲取部門列表.  
    22. 
  
  
  22.         /// 管理員須擁有’獲取部門列表’的接口權(quán)限，以及對(duì)部門的查看權(quán)限。  
    23. 
  
  
  23.         ///   
    24. 
  
  
  24.         CommonResult UpdateDept(string accessToken, int id, string name);   
    25. 
  
  
  25.         #endregion 
    26.

如創(chuàng)建部門的接口實(shí)現(xiàn)如下所示，主要就是構(gòu)建URL和POST的數(shù)據(jù)包，然后統(tǒng)一調(diào)用并獲取返回?cái)?shù)據(jù)，轉(zhuǎn)換為具體的Json對(duì)象實(shí)體即可。其他接口的實(shí)現(xiàn)方式類似，不在贅述。

 
 
    
  
  
  1. ///   
    2. 
  
  
  2.         /// 創(chuàng)建部門。  
    3. 
  
  
  3.         /// 管理員須擁有“操作通訊錄”的接口權(quán)限，以及父部門的管理權(quán)限。  
    4. 
  
  
  4.         ///   
    5. 
  
  
  5.         public CorpDeptCreateJson CreateDept(string accessToken, string name, string parentId)  
    6. 
  
  
  6.         {  
    7. 
  
  
  7.             string urlFormat = "https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token={0}";  
    8. 
  
  
  8.             var data = new 
    9. 
  
  
  9.             {  
    10. 
  
  
  10.                 name = name,  
    11. 
  
  
  11.                 parentId = parentId  
    12. 
  
  
  12.             };  
    13. 
  
  
  13.             var url = string.Format(urlFormat, accessToken);  
    14. 
  
  
  14.             var postData = data.ToJson();  
    15. 
  
  
  15.  
    16. 
  
  
  16.             CorpDeptCreateJson result = CorpJsonHelper.ConvertJson(url, postData);  
    17. 
  
  
  17.             return result;  
    18. 
  
  
  18.         } 
    19.

CorpDeptCreateJson 對(duì)象實(shí)體類的定義如下所示，我們主要是根據(jù)返回結(jié)果進(jìn)行定義的。

 
 
    
  
  
  1. ///   
    2. 
  
  
  2.     /// 創(chuàng)建部門的返回結(jié)果  
    3. 
  
  
  3.     ///   
    4. 
  
  
  4.     public class CorpDeptCreateJson : BaseJsonResult  
    5. 
  
  
  5.     {  
    6. 
  
  
  6.         ///   
    7. 
  
  
  7.         /// 返回的錯(cuò)誤消息  
    8. 
  
  
  8.         ///   
    9. 
  
  
  9.         public CorpReturnCode errcode { get; set; }  
    10. 
  
  
  10.  
    11. 
  
  
  11.         ///   
    12. 
  
  
  12.         /// 對(duì)返回碼的文本描述內(nèi)容  
    13. 
  
  
  13.         ///   
    14. 
  
  
  14.         public string errmsg { get; set; }  
    15. 
  
  
  15.  
    16. 
  
  
  16.         ///   
    17. 
  
  
  17.         /// 創(chuàng)建的部門id。  
    18. 
  
  
  18.         ///   
    19. 
  
  
  19.         public int id { get; set; }  
    20. 
  
  
  20.     } 
    21.

3、部門管理的API調(diào)用

 上面小節(jié)介紹了如何封裝部門管理的API，那么我們封裝好了對(duì)應(yīng)的接口和接口實(shí)現(xiàn)，怎么樣在實(shí)際環(huán)境里面進(jìn)行調(diào)用處理的呢，為了方便我創(chuàng)建一個(gè)小的Winform程序來測試對(duì)應(yīng)API的功能，如下所示。

下面我們來介紹一下調(diào)用的代碼和效果展示。

 
 
    
  
  
  1. private void btnCreateDeleteDept_Click(object sender, EventArgs e)  
    2. 
  
  
  2.         {  
    3. 
  
  
  3.             ICorpAddressBookApi bll = new CorpAddressBookApi();  
    4. 
  
  
  4.             string name = "測試部門";  
    5. 
  
  
  5.             CorpDeptCreateJson json = bll.CreateDept(token, name, "2");  
    6. 
  
  
  6.             if (json != null)  
    7. 
  
  
  7.             {  
    8. 
  
  
  8.                 Console.WriteLine("創(chuàng)建了部門：{0}， ID:{1}", name, json.id);  
    9. 
  
  
  9.  
    10. 
  
  
  10.                 //更新部門信息  
    11. 
  
  
  11.                 name = "測試部門修改名稱";  
    12. 
  
  
  12.                 CommonResult result = bll.UpdateDept(token, json.id, name);  
    13. 
  
  
  13.                 if(result != null)  
    14. 
  
  
  14.                 {  
    15. 
  
  
  15.                     Console.WriteLine("修改部門名稱:{0} {1}", (result.Success ? "成功" : "失敗"), result.ErrorMessage);  
    16. 
  
  
  16.                 }  
    17. 
  
  
  17.  
    18. 
  
  
  18.                 //刪除部門  
    19. 
  
  
  19.                 result = bll.DeleteDept(token, json.id);  
    20. 
  
  
  20.                 if (result != null)  
    21. 
  
  
  21.                 {  
    22. 
  
  
  22.                     Console.WriteLine("刪除部門名稱:{0} {1}", (result.Success ? "成功" : "失敗"), result.ErrorMessage);  
    23. 
  
  
  23.                 }  
    24. 
  
  
  24.             }  
    25. 
  
  
  25.               
    26. 
  
  
  26.         } 
    27. 
 
 
 
 
    
  
  
  1. ///   
    2. 
  
  
  2.         /// 獲取部門列表  
    3. 
  
  
  3.         ///   
    4. 
  
  
  4.         private void btnListDept_Click(object sender, EventArgs e)  
    5. 
  
  
  5.         {  
    6. 
  
  
  6.             ICorpAddressBookApi bll = new CorpAddressBookApi();  
    7. 
  
  
  7.             CorpDeptListJson list = bll.ListDept(token);  
    8. 
  
  
  8.             foreach (CorpDeptJson info in list.department)  
    9. 
  
  
  9.             {  
    10. 
  
  
  10.                 string tips = string.Format("{0}:{1}", info.name, info.id);  
    11. 
  
  
  11.                 Console.WriteLine(tips);  
    12. 
  
  
  12.             }  
    13. 
  
  
  13.         } 
    14.

原文出自：http://www.cnblogs.com/wuhuacong/p/3992230.html


網(wǎng)頁題目：微信企業(yè)號(hào)的通訊錄管理開發(fā)之部門管理
文章源于：http://www.dlmjj.cn/article/djphchg.html