微信企業號開發步驟

1.申請微信企業號測試帳號,參考http://www.cnblogs.com/comsokey/p/enterprise.html。php

2.熟悉微信企業號後臺功能,參考http://www.cnblogs.com/comsokey/p/enterprise.html。html

着重練習下通信錄管理,能夠先看本文的最後部分。數據庫

3.獲取AccessToken,參考http://qydev.weixin.qq.com/wiki/index.php?title=%E4%B8%BB%E5%8A%A8%E8%B0%83%E7%94%A8json

(1)系統管理員可經過管理端的權限管理功能建立管理組,分配管理組對應用、通信錄的訪問權限。完成後,管理組便可得到惟一的secret。api

(2)系統管理員可經過權限管理查看全部管理組的secret,其餘管理員可經過設置中的開發者憑據查看。微信

(3)當企業應用調用企業號接口時,企業號後臺爲根據這次訪問的AccessToken,校驗訪問的合法性以及所對應的管理組的管理權限以返回相應的結果。app

AccessToken須要用CorpIDSecret來換取,不一樣的Secret會返回不一樣的AccessToken。正常狀況下AccessToken有效期爲7200秒,有效期內重複獲取返回相同結果;有效期內有接口交互(包括獲取AccessToken的接口),會自動續期函數

下面首先說下如何獲得CorpIDSecret測試

點擊[建立並管理全部分級管理員帳號]url

如下界面會看到CorpID及Secret,

4.企業獲取code(參考http://qydev.weixin.qq.com/wiki/index.php?title=OAuth%E9%AA%8C%E8%AF%81%E6%8E%A5%E5%8F%A3)

 這裏的獲取code以及上面第三點中獲取的AccessToken,都是爲了下一步獲取userid作準備,這裏先討論如何獲取code。

企業若是須要員工在跳轉到企業網頁時帶上員工的身份信息,需構造以下的連接:(注意必須在微信中發起,作法能夠是新建一個菜單,而後將下面連接綁定到菜單項)

https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect

舉個例子(appid是上節獲得的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

接下來講一下如何將連接綁定到菜單項。仍是在本身的微信企業號後臺:

應用中心,以下圖:

新建一個應用:

好比考勤,建好後,點擊考勤,進到如下界面:

點擊模式選擇下的普通模式,進入到如下界面:

點擊啓用

點右上角加號:

點擊跳轉到網頁按鈕,將上面 的連接添加到裏面,以下圖所示:

不要忘記保存和發佈。

須要注意的是:此URL的域名,必須徹底匹配企業應用設置項中的'可信域名'(若是你的redirect_uri有端口號,那'可信域名'也必須加上端口號),不然跳轉時會提示redirect_uri參數錯誤。

 設置可信域名的地方在下面這裏:

點擊菜單,會訪問如下連接:

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

會新跳轉到一個新連接,在微信裏點擊複製連接:

頁面將跳轉至 redirect_uri/?code=CODE&state=STATE

在程序裏,咱們能夠經過request["code"]拿到CODE

這個CODE參數加上上節的AccessToken有助於咱們拿到登陸者的userid,而經過這個userid(按必定規則定義),咱們能夠識別登陸者身份。

 

5.根據code及AccessToken獲取成員信息

(參考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)企業成員受權時返回示例以下:

{
   "UserId":"USERID",
   "DeviceId":"DEVICEID"
}
經過這個userid,咱們能夠獲得登陸者信息,好比userid當時在後臺定義成回匯雅_財務_張三],咱們能夠經過userid解析出登陸者的工廠和角色,從而決定出其可以使用系統功能範圍。

userid是第一部分中,申請到測試企業號後,本身在用戶管理界面中添加的。注意,要先在後臺添加好用戶(用戶的微信號,電話,郵箱),而後相應用戶掃描微信號才能夠關注成功。

 這篇文章的例子不錯,能夠參考一下:

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);
                    //或跳轉到本身的頁面,想怎麼處理就怎麼處理
                    //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

     //根據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);
        //微信回傳的數據爲Json格式,將Json格式轉化成對象
        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
    //根據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"))
        {
            //可能發生錯誤
        }
        return returnText;
    }
    /// <summary>
    /// token類
    /// </summary>
    public class AccessToken
    {
        public AccessToken()
        {

            //
            //TODO: 在此處添加構造函數邏輯
            //
        }
        //access_token    網頁受權接口調用憑證,注意:此access_token與基礎支持的access_token不一樣
        //expires_in    access_token接口調用憑證超時時間,單位(秒)

        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 數據庫字段
        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格式數據轉化成對象
    /// </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);
            }
        }
    }
}
相關文章
相關標籤/搜索