前の記事では、エンタープライズ アカウントに関するいくつかの基本情報(bào)を提供し、エンタープライズ アカウント サーバーとの通信のブリッジを?qū)g現(xiàn)するためにエンタープライズ アカウントのコールバック メソッドを構(gòu)成する方法を紹介しました。この記事では主にエンタープライズ アカウントの開発作業(yè)を引き続き紹介し、WeChat エンタープライズ アカウントのアドレス帳管理および開発機(jī)能を紹介し、組織內(nèi)の部門情報(bào)を取得および管理する方法を紹介します。

1. エンタープライズ組織の作成と構(gòu)成

まず第一に、エンタープライズアカウントの管理背景に組織を作成し、開発と使用を容易にするためにその中にいくつかの部門と人員リストを作成できます。

たとえば、以下の図に示すように、Guangzhou Aiqidi のルート構(gòu)造を作成し、その中にいくつかの組織構(gòu)造を作成します。

その後、組織構(gòu)造「Guangzhou Aiqidi」のルート ノードに管理者権限を追加します。後で、インターフェイスを開発するときに、この管理者の権限 Secret 値を使用して呼び出しを行うことができます。

CorpID はエンタープライズ アカウントの ID であり、Secret は管理グループの資格情報(bào)キーです。
システム管理者は、管理側(cè)の権限管理機(jī)能を通じて管理グループを作成し、アプリケーション、アドレス帳、インターフェイスへの管理グループのアクセス権を割り當(dāng)てることができます。完了すると、管理グループは一意のシークレットを取得できます。システム管理者は、アクセス許可管理を通じてすべての管理グループのシークレットを表示でき、他の管理者は設(shè)定の開発者の資格情報(bào)を通じてシークレットを表示できます。

私のエンタープライズアカウントの作成者と「Guangzhou Iqidi」組織構(gòu)造の管理者は異なります。Secret は管理グループの資格情報(bào)キーであるため、管理者が別の組織の管理を擔(dān)當(dāng)している場(chǎng)合は、自分の管理シークレット値が必要になります。もしかしたら違うのかもしれない。インターフェイスを呼び出す必要がある場(chǎng)合は、次の図に示すように、獨(dú)自のアクセス許可レベルに屬する Secret 値を使用する必要があります。

エンタープライズ アカウントの作成者ではない場(chǎng)合、內(nèi)部の一部の権限割り當(dāng)ては変更できない場(chǎng)合があり、表示のみが可能です。

2. API アクセス用のグローバルに一意な AccessToken の取得

公式アカウントと同様に、エンタープライズ アカウント API を呼び出すときの最初のステップは、アクセス用の AccessToken を取得することです。このチケットはグローバルであり、一定の適時(shí)性と頻度の制御があるため、適切にキャッシュする必要があり、呼び出されるたびに更新することはできません。

エンタープライズ アカウントがアクセス チケットを取得するための主なロジック コードは次のとおりです。主なことは、管理者のシークレット値を使用して、対応するパスワードを取得し、どの組織構(gòu)造を管理しているかを知ることです。

????????///?<summary>
????????///?獲取每次操作微信API的Token訪問令牌????????///?</summary>
????????///?<param>企業(yè)Id
????????///?<param>管理組的憑證密鑰
????????///?<returns></returns>
????????public?string?GetAccessTokenNoCache(string?corpid,?string?corpsecret)
????????{????????????var?url?=?string.Format("http://m.miracleart.cn/{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;
????????}</token>

WeChat エンタープライズ アカウントの説明は次のとおりです:

エンタープライズ アプリケーションがエンタープライズ アカウント インターフェイスを呼び出すと、エンタープライズ アカウントのバックグラウンドは、アクセスの合法性とアクセス トークンに基づいて検証します。対応する結(jié)果を返すための、対応する管理グループの管理権限。

注: 過度の権限は、誤操作や情報(bào)セキュリティのリスクを高める可能性があるため、慎重に設(shè)定する必要があります。

AccessToken は、インターフェースを呼び出すときに、エンタープライズ アカウントのグローバルに一意なチケットです。 AccessToken は CorpID と交換する必要があり、Secret が異なれば異なる AccessToken が返されます。 通常の狀況では、AccessToken は 7200 秒有効です。有効期間內(nèi)に繰り返し取得すると同じ結(jié)果が返され、自動(dòng)的に更新されます。 access_token を取得するための API 呼び出しの數(shù)は非常に限られているため、企業(yè)は access_token をグローバルに保存および更新すると API 呼び出しが制限され、自社のビジネスに影響を與えることをお?jiǎng)幛幛筏蓼埂?

2. アドレス帳管理における部門情報(bào)のメンテナンス

最初のセクションのアクセス チケットを使用すると、組織構(gòu)造の取得、作成、削除、その他の機(jī)能を含む多くのことを行うために API を使用できます。

作成部の公式インターフェース定義は以下の通りです。

• 説明のリクエスト

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

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

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

{
???"name":?"郵箱產(chǎn)品組",
???"parentid":?"1"
}

• 參數(shù)說明

參數(shù)	必須	說明
access_token	是	調(diào)用接口憑證
name	是	部門名稱。長(zhǎng)度限制為1~64個(gè)字符
parentid	是	父親部門id。根部門id為1

?

• 返回結(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)限，以及對(duì)部門的查看權(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)用并獲取返回?cái)?shù)據(jù)，轉(zhuǎn)換為具體的Json對(duì)象實(shí)體即可。其他接口的實(shí)現(xiàn)方式類似，不在贅述。

????????///?<summary>
????????///?創(chuàng)建部門。????????///?管理員須擁有“操作通訊錄”的接口權(quán)限，以及父部門的管理權(quán)限。????????///?</summary>
????????public?CorpDeptCreateJson?CreateDept(string?accessToken,?string?name,?string?parentId)
????????{????????????string?urlFormat?=?"http://m.miracleart.cn/{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>

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

????///?<summary>
????///?創(chuàng)建部門的返回結(jié)果????///?</summary>
????public?class?CorpDeptCreateJson?:?BaseJsonResult
????{????????///?<summary>
????????///?返回的錯(cuò)誤消息????????///?</summary>
????????public?CorpReturnCode?errcode?{?get;?set;?}????????///?<summary>
????????///?對(duì)返回碼的文本描述內(nèi)容????????///?</summary>
????????public?string?errmsg?{?get;?set;?}????????///?<summary>
????????///?創(chuàng)建的部門id。????????///?</summary>
????????public?int?id?{?get;?set;?}
????}

?

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

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

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

????????private?void?btnCreateDeleteDept_Click(object?sender,?EventArgs?e)
????????{
????????????ICorpAddressBookApi?bll?=?new?CorpAddressBookApi();????????????string?name?=?"測(cè)試部門";
????????????CorpDeptCreateJson?json?=?bll.CreateDept(token,?name,?"2");????????????if?(json?!=?null)
????????????{
????????????????Console.WriteLine("創(chuàng)建了部門：{0}，?ID:{1}",?name,?json.id);????????????????//更新部門信息
????????????????name?=?"測(cè)試部門修改名稱";
????????????????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);
????????????}
????????}

?

?更多WeChatポータルのC#開発とアドレス帳管理の部門管理、WeChatエンタープライズアカウントを利用した開発相關(guān)文章請(qǐng)關(guān)注PHP中文網(wǎng)！