C#開發(fā)微信門戶及應(yīng)用(17)-微信企業(yè)號的通訊錄管理開發(fā)之部門管理

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

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

首先我們可以在企業(yè)號的管理后臺里面創(chuàng)建一個組織機(jī)構(gòu)拣宏,里面創(chuàng)建一些部門和人員列表沈贝,方便我們開發(fā)和使用。
例如創(chuàng)建一個廣州愛奇迪的根結(jié)構(gòu)勋乾,然后在其中在創(chuàng)建一些組織機(jī)構(gòu)宋下,如下圖所示。



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



CorpID是企業(yè)號的標(biāo)識,每個企業(yè)號擁有一個唯一的CorpID各吨;Secret是管理組憑證密鑰枝笨。系統(tǒng)管理員可通過管理端的權(quán)限管理功能創(chuàng)建管理組,分配管理組對應(yīng)用揭蜒、通訊錄横浑、接口的訪問權(quán)限。完成后屉更,管理組即可獲得唯一的secret徙融。系統(tǒng)管理員可通過權(quán)限管理查看所有管理組的secret,其他管理員可通過設(shè)置中的開發(fā)者憑據(jù)查看瑰谜。
我的企業(yè)號的創(chuàng)建者和“廣州愛奇迪”組織結(jié)構(gòu)的管理員是不同的张咳,由于Secret是管理組憑證密鑰,因此管理者負(fù)責(zé)不同的組織機(jī)構(gòu)管理的話似舵,自己的管理Secret值可能就不同了。如果我們需要調(diào)用接口葱峡,就需要用到這個屬于自己權(quán)限級別的Secret值砚哗,如下圖所示。

如果不是企業(yè)號的創(chuàng)建者砰奕,那么可能不能修改里面的一些權(quán)限分配蛛芥,只能查看提鸟。


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

和公眾號一樣仅淑,我們調(diào)用企業(yè)號API的第一步也是需要先獲取訪問的票據(jù)AccessToken称勋。這個票據(jù)是全局性的,有一定的時效和頻率控制涯竟,因此需要適當(dāng)?shù)倪M(jìn)行緩存赡鲜,不能每次調(diào)用都去刷新獲取。
企業(yè)號獲取訪問票據(jù)的主要的邏輯代碼如下所示庐船,其主要的就是需要使用管理者的Secret值去獲取對應(yīng)的口令银酬,這樣它就能夠知道管理的是那個組織結(jié)構(gòu)的了。

/// <summary>
/// 獲取每次操作微信API的Token訪問令牌
/// </summary>
/// <param name="corpid">企業(yè)Id</param>
/// <param name="corpsecret">管理組的憑證密鑰</param>
/// <returns></returns>
public string GetAccessTokenNoCache(string corpid, string corpsecret)
{
    var url = string.Format("https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={0}&corpsecret={1}",
                            corpid, corpsecret);

    HttpHelper helper = new HttpHelper();
    string result = helper.GetHtml(url);
    string regex = "\"access_token\":\"(?<token>.*?)\"";

    string token = CRegex.GetText(result, regex, "token");
    return token;
}

微信企業(yè)號的說明如下所示:
當(dāng)企業(yè)應(yīng)用調(diào)用企業(yè)號接口時筐钟,企業(yè)號后臺為根據(jù)此次訪問的AccessToken,校驗(yàn)訪問的合法性以及所對應(yīng)的管理組的管理權(quán)限以返回相應(yīng)的結(jié)果揩瞪。
注:你應(yīng)該審慎配置管理組的權(quán)限,夠用即好篓冲,權(quán)限過大會增加誤操作可能性及信息安全隱患李破。
AccessToken是企業(yè)號的全局唯一票據(jù),調(diào)用接口時需攜帶AccessToken壹将。AccessToken需要用CorpIDSecret來換取嗤攻,不同的Secret會返回不同的AccessToken。正常情況下AccessToken有效期為7200秒瞭恰,有效期內(nèi)重復(fù)獲取返回相同結(jié)果屯曹,并自動續(xù)期。由于獲取access_token的api調(diào)用次數(shù)非常有限惊畏,建議企業(yè)全局存儲與更新access_token恶耽,頻繁刷新access_token會導(dǎo)致api調(diào)用受限,影響自身業(yè)務(wù)颜启。

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

有了第一節(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)體為:
{ "name": "郵箱產(chǎn)品組", "parentid": "1"}

參數(shù)說明

Paste_Image.png

返回結(jié)果

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

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

#region 部門管理
/// <summary>
/// 創(chuàng)建部門。
/// 管理員須擁有“操作通訊錄”的接口權(quán)限须尚,以及父部門的管理權(quán)限崖堤。
/// </summary>
CorpDeptCreateJson CreateDept(string accessToken, string name, string parentId);

/// <summary>
/// 更新部門侍咱。
/// 管理員須擁有“操作通訊錄”的接口權(quán)限,以及該部門的管理權(quán)限密幔。
/// </summary>
CommonResult DeleteDept(string accessToken, int id);

/// <summary>
/// 刪除部門.
/// 管理員須擁有“操作通訊錄”的接口權(quán)限楔脯,以及該部門的管理權(quán)限。
/// </summary>
CorpDeptListJson ListDept(string accessToken);

/// <summary>
/// 獲取部門列表.
/// 管理員須擁有’獲取部門列表’的接口權(quán)限胯甩,以及對部門的查看權(quán)限昧廷。
/// </summary>
CommonResult UpdateDept(string accessToken, int id, string name); 
#endregion

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

/// <summary>
/// 創(chuàng)建部門。
/// 管理員須擁有“操作通訊錄”的接口權(quán)限娇唯,以及父部門的管理權(quán)限齐遵。
/// </summary>
public CorpDeptCreateJson CreateDept(string accessToken, string name, string parentId)
{
    string urlFormat = "https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token={0}";
    var data = new
    {
        name = name,
        parentId = parentId
    };
    var url = string.Format(urlFormat, accessToken);
    var postData = data.ToJson();

    CorpDeptCreateJson result = CorpJsonHelper<CorpDeptCreateJson>.ConvertJson(url, postData);
    return result;
}

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

/// <summary>
/// 創(chuàng)建部門的返回結(jié)果
/// </summary>
public class CorpDeptCreateJson : BaseJsonResult
{
    /// <summary>
    /// 返回的錯誤消息
    /// </summary>
    public CorpReturnCode errcode { get; set; }

    /// <summary>
    /// 對返回碼的文本描述內(nèi)容
    /// </summary>
    public string errmsg { get; set; }

    /// <summary>
    /// 創(chuàng)建的部門id梗摇。
    /// </summary>
    public int id { get; set; }
}

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

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



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

private void btnCreateDeleteDept_Click(object sender, EventArgs e)
{
    ICorpAddressBookApi bll = new CorpAddressBookApi();
    string name = "測試部門";
    CorpDeptCreateJson json = bll.CreateDept(token, name, "2");
    if (json != null)
    {
        Console.WriteLine("創(chuàng)建了部門:{0}漱凝, ID:{1}", name, json.id);

        //更新部門信息
        name = "測試部門修改名稱";
        CommonResult result = bll.UpdateDept(token, json.id, name);
        if(result != null)
        {
            Console.WriteLine("修改部門名稱:{0} {1}", (result.Success ? "成功" : "失敗"), result.ErrorMessage);
        }

        //刪除部門
        result = bll.DeleteDept(token, json.id);
        if (result != null)
        {
            Console.WriteLine("刪除部門名稱:{0} {1}", (result.Success ? "成功" : "失敗"), result.ErrorMessage);
        }
    }
    
}
/// <summary>
/// 獲取部門列表
/// </summary>
private void btnListDept_Click(object sender, EventArgs e)
{
    ICorpAddressBookApi bll = new CorpAddressBookApi();
    CorpDeptListJson list = bll.ListDept(token);
    foreach (CorpDeptJson info in list.department)
    {
        string tips = string.Format("{0}:{1}", info.name, info.id);
        Console.WriteLine(tips);
    }
}

如果對這個《C#開發(fā)微信門戶及應(yīng)用》系列感興趣疮蹦,可以關(guān)注我的其他文章.

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市茸炒,隨后出現(xiàn)的幾起案子愕乎,更是在濱河造成了極大的恐慌,老刑警劉巖壁公,帶你破解...
    沈念sama閱讀 216,372評論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件感论,死亡現(xiàn)場離奇詭異,居然都是意外死亡紊册,警方通過查閱死者的電腦和手機(jī)比肄,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,368評論 3 392
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人薪前,你說我怎么就攤上這事」匦保” “怎么了示括?”我有些...
    開封第一講書人閱讀 162,415評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長痢畜。 經(jīng)常有香客問我垛膝,道長,這世上最難降的妖魔是什么丁稀? 我笑而不...
    開封第一講書人閱讀 58,157評論 1 292
  • 正文 為了忘掉前任吼拥,我火速辦了婚禮,結(jié)果婚禮上线衫,老公的妹妹穿的比我還像新娘凿可。我一直安慰自己,他們只是感情好授账,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,171評論 6 388
  • 文/花漫 我一把揭開白布枯跑。 她就那樣靜靜地躺著,像睡著了一般白热。 火紅的嫁衣襯著肌膚如雪敛助。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,125評論 1 297
  • 那天屋确,我揣著相機(jī)與錄音纳击,去河邊找鬼。 笑死攻臀,一個胖子當(dāng)著我的面吹牛焕数,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播茵烈,決...
    沈念sama閱讀 40,028評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼百匆,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了呜投?” 一聲冷哼從身側(cè)響起加匈,我...
    開封第一講書人閱讀 38,887評論 0 274
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎仑荐,沒想到半個月后雕拼,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,310評論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡粘招,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,533評論 2 332
  • 正文 我和宋清朗相戀三年啥寇,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,690評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡辑甜,死狀恐怖衰絮,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情磷醋,我是刑警寧澤猫牡,帶...
    沈念sama閱讀 35,411評論 5 343
  • 正文 年R本政府宣布,位于F島的核電站邓线,受9級特大地震影響淌友,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜骇陈,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,004評論 3 325
  • 文/蒙蒙 一震庭、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧你雌,春花似錦器联、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至逛球,卻和暖如春千元,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背颤绕。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評論 1 268
  • 我被黑心中介騙來泰國打工幸海, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人奥务。 一個月前我還...
    沈念sama閱讀 47,693評論 2 368
  • 正文 我出身青樓物独,卻偏偏與公主長得像,于是被迫代替她去往敵國和親氯葬。 傳聞我的和親對象是個殘疾皇子挡篓,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,577評論 2 353

推薦閱讀更多精彩內(nèi)容