1.申請微信企業(yè)號測試賬號,參考http://www.cnblogs.com/comsokey/p/enterprise.html。
2.熟悉微信企業(yè)號后臺功能,參考http://www.cnblogs.com/comsokey/p/enterprise.html。
著重練習(xí)下通訊錄管理,可以先看本文的最后部分。
3.獲取AccessToken,參考http://qydev.weixin.qq.com/wiki/index.php?title=%E4%B8%BB%E5%8A%A8%E8%B0%83%E7%94%A8
(1)系統(tǒng)管理員可通過管理端的權(quán)限管理功能創(chuàng)建管理組,分配管理組對應(yīng)用、通訊錄的訪問權(quán)限。完成后,管理組即可獲得唯一的secret。
(2)系統(tǒng)管理員可通過權(quán)限管理查看所有管理組的secret,其他管理員可通過設(shè)置中的開發(fā)者憑據(jù)查看。
(3)當企業(yè)應(yīng)用調(diào)用企業(yè)號接口時,企業(yè)號后臺為根據(jù)此次訪問的AccessToken,校驗訪問的合法性以及所對應(yīng)的管理組的管理權(quán)限以返回相應(yīng)的結(jié)果。
AccessToken需要用CorpID和Secret來換取,不同的Secret會返回不同的AccessToken。正常情況下AccessToken有效期為7200秒,有效期內(nèi)重復(fù)獲取返回相同結(jié)果;有效期內(nèi)有接口交互(包括獲取AccessToken的接口),會自動續(xù)期。
點擊[創(chuàng)建并管理所有分級管理員賬號]
以下界面會看到CorpID及Secret,
4.企業(yè)獲取code(參考http://qydev.weixin.qq.com/wiki/index.php?title=OAuth%E9%AA%8C%E8%AF%81%E6%8E%A5%E5%8F%A3)
企業(yè)如果需要員工在跳轉(zhuǎn)到企業(yè)網(wǎng)頁時帶上員工的身份信息,需構(gòu)造如下的鏈接:(注意必須在微信中發(fā)起,做法可以是新建一個菜單,然后將下面鏈接綁定到菜單項)
舉個例子(appid是上節(jié)得到的CorpID)
https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx4396b735dd7d0519&redirect_uri=http://www.douyh.com&response_type=code&scope=snsapi_base&state=111&connect_redirect=1#wechat_redirect
接下來說一下如何將鏈接綁定到菜單項。還是在自己的微信企業(yè)號后臺:
應(yīng)用中心,如下圖:
新建一個應(yīng)用:
比如考勤,建好后,點擊考勤,進到以下界面:
點擊模式選擇下的普通模式,進入到以下界面:
點擊啟用
點右上角加號:
點擊跳轉(zhuǎn)到網(wǎng)頁按鈕,將上面 的鏈接添加到里面,如下圖所示:
不要忘記保存和發(fā)布。
需要注意的是:此URL的域名,必須完全匹配企業(yè)應(yīng)用設(shè)置項中的'可信域名'(如果你的redirect_uri有端口號,那'可信域名'也必須加上端口號),否則跳轉(zhuǎn)時會提示redirect_uri參數(shù)錯誤。
設(shè)置可信域名的地方在下面這里:
點擊菜單,會訪問以下鏈接:
https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx4396b735dd7d0519&redirect_uri=http://www.douyh.com&response_type=code&scope=snsapi_base&state=111&connect_redirect=1#wechat_redirect
會新跳轉(zhuǎn)到一個新鏈接,在微信里點擊復(fù)制鏈接:
頁面將跳轉(zhuǎn)至 redirect_uri/?code=CODE&state=STATE
在程序里,我們可以通過request['code']拿到CODE
這個CODE參數(shù)加上上節(jié)的AccessToken有助于我們拿到登錄者的userid,而通過這個userid(按一定規(guī)則定義),我們可以識別登錄者身份。
(參考http://qydev.weixin.qq.com/wiki/index.php?title=OAuth%E9%AA%8C%E8%AF%81%E6%8E%A5%E5%8F%A3)
Https請求方式:GET
https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE
a)企業(yè)成員授權(quán)時返回示例如下:
{ 'UserId':'USERID', 'DeviceId':'DEVICEID'}
通過這個userid,我們可以得到登錄者信息,比如userid當時在后臺定義成回匯雅_財務(wù)_張三],我們可以通過userid解析出登錄者的工廠和角色,從而決定出其能夠使用系統(tǒng)功能范圍。
userid是第一部分中,申請到測試企業(yè)號后,自己在用戶管理界面中添加的。注意,要先在后臺添加好用戶(用戶的微信號,電話,郵箱),然后相應(yīng)用戶掃描微信號才可以關(guān)注成功。
這篇文章的例子不錯,可以參考一下:
http://blog.csdn.net/angle_greensky110/article/details/32936289
以下給出一段例子代碼:
using System;using System.Data;using System.Configuration;using System.Collections;using System.Web;using System.Web.Security;using System.Web.UI;using System.Web.UI.WebControls;using System.Web.UI.WebControls.WebParts;using System.Web.UI.HtmlControls;using System.Net;using System.Text;using System.Runtime.Serialization.Json;using System.IO;using System.Data.SqlClient;public partial class wxProcess2 : System.Web.UI.Page{ public string reurl = ''; protected void Page_Load(object sender, EventArgs e) { if (!IsPostBack) { string code = ''; if (Request.QueryString['code'] != null && Request.QueryString['code'] != '') { //獲取微信回傳的code code = Request.QueryString['code'].ToString(); AccessToken Model = Get_AccessToken(); //獲取token OAuthUser OAuthUser_Model = Get_UserInfo(Model.access_token, code); if (OAuthUser_Model.UserId != null && OAuthUser_Model.UserId != '') //已獲取得openid及其他信息 { //在頁面上輸出用戶信息 Response.Write('用戶UserId:' + OAuthUser_Model.UserId); //或跳轉(zhuǎn)到自己的頁面,想怎么處理就怎么處理 //Response.Redirect(reurl); } } } } #region 屬性 public string strCorpID = 'wx43b735dd7d0519'; //公眾微信平臺下可以找到 public string appsecret = 'nRqMz-tGd-rspiEKJDFp9DqaG-tj7NW3TRBIMlAHYjsKCD6L8MYsTIGCCdvGZC'; //公眾微信平臺下可以找到 #endregion //https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=id&corpsecret=secrect //根據(jù)appid,secret,code獲取微信openid、access token信息 protected AccessToken Get_AccessToken() { //獲取微信回傳的openid、access token string Str = GetJson('https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=' + strCorpID + '&corpsecret=' + appsecret); //微信回傳的數(shù)據(jù)為Json格式,將Json格式轉(zhuǎn)化成對象 AccessToken Oauth_Token_Model = JsonHelper.ParseFromJson<AccessToken>(Str); return Oauth_Token_Model; } // https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE //根據(jù)openid,access token獲得用戶信息 protected OAuthUser Get_UserInfo(string strAccessToken, string strCode) { string Str = GetJson('https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=' + strAccessToken + '&code=' + strCode); OAuthUser OAuthUser_Model = JsonHelper.ParseFromJson<OAuthUser>(Str); return OAuthUser_Model; } //訪問微信url并返回微信信息 protected string GetJson(string url) { WebClient wc = new WebClient(); wc.Credentials = CredentialCache.DefaultCredentials; wc.Encoding = Encoding.UTF8; string returnText = wc.DownloadString(url); if (returnText.Contains('errcode')) { //可能發(fā)生錯誤 } return returnText; } /// <summary> /// token類 /// </summary> public class AccessToken { public AccessToken() { // //TODO: 在此處添加構(gòu)造函數(shù)邏輯 // } //access_token 網(wǎng)頁授權(quán)接口調(diào)用憑證,注意:此access_token與基礎(chǔ)支持的access_token不同 //expires_in access_token接口調(diào)用憑證超時時間,單位(秒) private string _access_token; private string _expires_in; public string access_token { set { _access_token = value; } get { return _access_token; } } public string expires_in { set { _expires_in = value; } get { return _expires_in; } } } /// <summary> /// 用戶信息類 /// </summary> public class OAuthUser { public OAuthUser() { } #region 數(shù)據(jù)庫字段 private string _UserId; private string _DeviceId; #endregion #region 字段屬性 /// <summary> /// 用戶的唯一標識 /// </summary> public string UserId { set { _UserId = value; } get { return _UserId; } } /// <summary> /// /// </summary> public string DeviceId { set { _DeviceId = value; } get { return _DeviceId; } } #endregion } /// <summary> /// 將Json格式數(shù)據(jù)轉(zhuǎn)化成對象 /// </summary> public class JsonHelper { /// <summary> /// 生成Json格式 /// </summary> /// <typeparam name='T'></typeparam> /// <param name='obj'></param> /// <returns></returns> public static string GetJson<T>(T obj) { DataContractJsonSerializer json = new DataContractJsonSerializer(obj.GetType()); using (MemoryStream stream = new MemoryStream()) { json.WriteObject(stream, obj); string szJson = Encoding.UTF8.GetString(stream.ToArray()); return szJson; } } /// <summary> /// 獲取Json的Model /// </summary> /// <typeparam name='T'></typeparam> /// <param name='szJson'></param> /// <returns></returns> public static T ParseFromJson<T>(string szJson) { T obj = Activator.CreateInstance<T>(); using (MemoryStream ms = new MemoryStream(Encoding.UTF8.GetBytes(szJson))) { DataContractJsonSerializer serializer = new DataContractJsonSerializer(obj.GetType()); return (T)serializer.ReadObject(ms); } } }}