C#開發(fā)微信門戶及應用(17)-微信企業(yè)號的通訊錄管理開發(fā)之部門管理
當前位置:點晴教程→知識管理交流
→『 技術(shù)文檔交流 』
前面一篇隨筆企業(yè)號的一些基礎(chǔ)信息,以及介紹如何配置企業(yè)號的回調(diào)方式實現(xiàn)和企業(yè)號服務器進行溝通的橋梁。本篇主要還是繼續(xù)介紹企業(yè)號的開發(fā)工作的開展,介紹微信企業(yè)號通訊錄管理開發(fā)功能,介紹其中組織機構(gòu)里面如何獲取和管理部門的信息等內(nèi)容。
1、企業(yè)組織的創(chuàng)建和配置首先我們可以在企業(yè)號的管理后臺里面創(chuàng)建一個組織機構(gòu),里面創(chuàng)建一些部門和人員列表,方便我們開發(fā)和使用。 例如創(chuàng)建一個廣州愛奇迪的根結(jié)構(gòu),然后在其中在創(chuàng)建一些組織機構(gòu),如下圖所示。 然后給組織結(jié)構(gòu)根節(jié)點“廣州愛奇迪”增加一個管理員權(quán)限,以后再開發(fā)接口里面也就可以使用這個管理員所屬的權(quán)限Secret值進行調(diào)用了。 CorpID是企業(yè)號的標識,每個企業(yè)號擁有一個唯一的CorpID;Secret是管理組憑證密鑰。 我的企業(yè)號的創(chuàng)建者和“廣州愛奇迪”組織結(jié)構(gòu)的管理員是不同的,由于Secret是管理組憑證密鑰,因此管理者負責不同的組織機構(gòu)管理的話,自己的管理Secret值可能就不同了。如果我們需要調(diào)用接口,就需要用到這個屬于自己權(quán)限級別的Secret值,如下圖所示。 如果不是企業(yè)號的創(chuàng)建者,那么可能不能修改里面的一些權(quán)限分配,只能查看。 2、API訪問的全局唯一票據(jù)AccessToken的獲取和公眾號一樣,我們調(diào)用企業(yè)號API的第一步也是需要先獲取訪問的票據(jù)AccessToken。這個票據(jù)是全局性的,有一定的時效和頻率控制,因此需要適當?shù)倪M行緩存,不能每次調(diào)用都去刷新獲取。 企業(yè)號獲取訪問票據(jù)的主要的邏輯代碼如下所示,其主要的就是需要使用管理者的Secret值去獲取對應的口令,這樣它就能夠知道管理的是那個組織結(jié)構(gòu)的了。 /// <summary> 微信企業(yè)號的說明如下所示: 當企業(yè)應用調(diào)用企業(yè)號接口時,企業(yè)號后臺為根據(jù)此次訪問的AccessToken,校驗訪問的合法性以及所對應的管理組的管理權(quán)限以返回相應的結(jié)果。 注:你應該審慎配置管理組的權(quán)限,夠用即好,權(quán)限過大會增加誤操作可能性及信息安全隱患。 AccessToken是企業(yè)號的全局唯一票據(jù),調(diào)用接口時需攜帶AccessToken。AccessToken需要用CorpID和Secret來換取,不同的Secret會返回不同的AccessToken。正常情況下AccessToken有效期為7200秒,有效期內(nèi)重復獲取返回相同結(jié)果,并自動續(xù)期。由于獲取access_token的api調(diào)用次數(shù)非常有限,建議企業(yè)全局存儲與更新access_token,頻繁刷新access_token會導致api調(diào)用受限,影響自身業(yè)務。
2、通訊錄管理之部門信息的維護有了第一節(jié)里面的訪問票據(jù),我們就可以利用API來做很多事情了,包括組織結(jié)構(gòu)的獲取、創(chuàng)建、刪除等等功能。 創(chuàng)建部門的官方接口定義如下所示。
Https請求方式: POST https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token=ACCESS_TOKEN 請求包結(jié)構(gòu)體為: {
{ 根據(jù)上面的一些類似的接口定義說明,我們先來定義下組織機構(gòu)部門數(shù)據(jù)的維護接口,然后在逐步實現(xiàn)和調(diào)用。 #region 部門管理 如創(chuàng)建部門的接口實現(xiàn)如下所示,主要就是構(gòu)建URL和POST的數(shù)據(jù)包,然后統(tǒng)一調(diào)用并獲取返回數(shù)據(jù),轉(zhuǎn)換為具體的Json對象實體即可。其他接口的實現(xiàn)方式類似,不在贅述。 /// <summary> CorpDeptCreateJson 對象實體類的定義如下所示,我們主要是根據(jù)返回結(jié)果進行定義的。 /// <summary>
3、部門管理的API調(diào)用上面小節(jié)介紹了如何封裝部門管理的API,那么我們封裝好了對應的接口和接口實現(xiàn),怎么樣在實際環(huán)境里面進行調(diào)用處理的呢,為了方便我創(chuàng)建一個小的Winform程序來測試對應API的功能,如下所示。 下面我們來介紹一下調(diào)用的代碼和效果展示。 private void btnCreateDeleteDept_Click(object sender, EventArgs e) /// <summary>
如果對這個《C#開發(fā)微信門戶及應用》系列感興趣,可以關(guān)注我的其他文章,系列隨筆如下所示: C#開發(fā)微信門戶及應用(20)-微信企業(yè)號的菜單管理 C#開發(fā)微信門戶及應用(19)-微信企業(yè)號的消息發(fā)送(文本、圖片、文件、語音、視頻、圖文消息等) C#開發(fā)微信門戶及應用(18)-微信企業(yè)號的通訊錄管理開發(fā)之成員管理 C#開發(fā)微信門戶及應用(17)-微信企業(yè)號的通訊錄管理開發(fā)之部門管理 C#開發(fā)微信門戶及應用(16)-微信企業(yè)號的配置和使用 C#開發(fā)微信門戶及應用(15)-微信菜單增加掃一掃、發(fā)圖片、發(fā)地理位置功能 C#開發(fā)微信門戶及應用(14)-在微信菜單中采用重定向獲取用戶數(shù)據(jù) C#開發(fā)微信門戶及應用(13)-使用地理位置擴展相關(guān)應用 C#開發(fā)微信門戶及應用(11)--微信菜單的多種表現(xiàn)方式介紹 C#開發(fā)微信門戶及應用(10)--在管理系統(tǒng)中同步微信用戶分組信息 C#開發(fā)微信門戶及應用(9)-微信門戶菜單管理及提交到微信服務器 C#開發(fā)微信門戶及應用(8)-微信門戶應用管理系統(tǒng)功能介紹 C#開發(fā)微信門戶及應用(7)-微信多客服功能及開發(fā)集成 C#開發(fā)微信門戶及應用(6)--微信門戶菜單的管理操作 C#開發(fā)微信門戶及應用(4)--關(guān)注用戶列表及詳細信息管理 C#開發(fā)微信門戶及應用(3)--文本消息和圖文消息的應答 C#開發(fā)微信門戶及應用(2)--微信消息的處理和應答
![]() 專注于Winform開發(fā)框架、Web開發(fā)框架、WCF開發(fā)框架的研究及應用。 轉(zhuǎn)載請注明出處: ![]() 該文章在 2014/12/2 0:59:26 編輯過 |
關(guān)鍵字查詢
相關(guān)文章
正在查詢... |