C#-Entwicklung des WeChat-Portals und der WeChat-Anwendung (4) – Befolgen Sie die Benutzerliste und die detaillierte Informationsverwaltung

Letzten Monat habe ich die Entwicklung von WeChat-Portalen und -Anwendungen in C# vorgestellt und mehrere Aufsätze zum Teilen geschrieben. Aus Zeitgründen habe ich diese Blogreihe eine Weile nicht weitergeschrieben. Darum haben wir nicht aufgehört zu recherchieren , aber um die Technologie in diesem Bereich weiter eingehend zu erforschen, haben wir uns auf die Entwicklung der zugrunde liegenden Technologie konzentriert.

Eine sehr wichtige Funktion von WeChat ist, dass es die große Benutzerbasis seiner Plattform nutzen kann, sodass es einfach in das CRM-System (Customer Relationship Management) integriert werden kann und Abonnements relevant pushen können Informationen zu Produktneuigkeiten und interaktiven Gesprächen mit aktiven Benutzern, die innerhalb von 48 Stunden auf Nachrichten und Ereignisse geantwortet haben. In diesem Aufsatz wird hauptsächlich beschrieben, wie Benutzerinformationen angezeigt werden , Gruppenverwaltung usw. Anwendungen entwickeln.

1. Follower-Benutzerliste und Benutzergruppeninformationen

Auf der WeChat-Verwaltungsplattform können wir die Follower-Benutzer unseres Kontos und Benutzergruppeninformationen sehen, wie unten gezeigt.

In der obigen Verwaltungsoberfläche können Sie die grundlegenden Informationen der Follower-Benutzer sehen, aber was Sie mit der WeChat-API erhalten, ist eine Liste namens OpenID. Lassen Sie uns dies zuerst verstehen. Was ist das Ding? Die Beschreibung der WeChat-API liefert die folgende Analyse:

Die Follower-Liste besteht aus einer Reihe von OpenIDs (verschlüsselten WeChat-IDs für jedes öffentliche Konto). Die OpenID des Benutzers ist unterschiedlich). Offizielle Konten können diese Schnittstelle verwenden, um grundlegende Benutzerinformationen basierend auf OpenID abzurufen, einschließlich Spitzname, Avatar, Geschlecht, Stadt, Sprache und Follow-Zeit.

Die Bedeutung der obigen Analyse ist sehr klar, das heißt, wenn ein Benutzer unserem offiziellen Konto folgt, egal wie oft er ihm folgt, ist dies ein bestimmter Wert für unser offizielles Konto Für andere öffentliche Konten haben sie unterschiedliche OpenIDs.

WeChat stellt einige Schlüsselwortinformationen bereit, um benutzerbezogene Inhalte aufzuzeichnen. Basierend auf den relevanten Definitionen des Benutzers definieren wir eine Entitätsklasse, um die abgerufenen Benutzerinformationen zu platzieren.

    /// <summary>
    /// 高级接口获取的用户信息。    /// 在关注者与公众号产生消息交互后，公众号可获得关注者的OpenID    /// （加密后的微信号，每个用户对每个公众号的OpenID是唯一的。对于不同公众号，同一用户的openid不同）。    /// 公众号可通过本接口来根据OpenID获取用户基本信息，包括昵称、头像、性别、所在城市、语言和关注时间。    /// </summary>
    public class UserJson : BaseJsonResult
    {        /// <summary>
        /// 用户是否订阅该公众号标识，值为0时，代表此用户没有关注该公众号，拉取不到其余信息。        /// </summary>
        public int subscribe { get; set; }        /// <summary>
        /// 用户的标识，对当前公众号唯一        /// </summary>
        public string openid { get; set; }        /// <summary>
        /// 用户的昵称        /// </summary>
        public string nickname { get; set; }        /// <summary>
        /// 用户的性别，值为1时是男性，值为2时是女性，值为0时是未知        /// </summary>
        public int sex { get; set; }        /// <summary>
        /// 用户的语言，简体中文为zh_CN        /// </summary>
        public string language { get; set; }        /// <summary>
        /// 用户所在城市        /// </summary>
        public string city { get; set; }        /// <summary>
        /// 用户所在省份        /// </summary>
        public string province { get; set; }        /// <summary>
        /// 用户所在国家        /// </summary>
        public string country { get; set; }        /// <summary>
        /// 用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640*640正方形头像），用户没有头像时该项为空        /// </summary>
        public string headimgurl { get; set; }        /// <summary>
        /// 用户关注时间，为时间戳。如果用户曾多次关注，则取最后关注时间        /// </summary>
        public long subscribe_time { get; set; }
    }

Gemäß der Gruppierungsinformationsdefinition definieren wir eine gruppierte Entitätsklasseninformation.

    /// <summary>
    /// 分组信息    /// </summary>
    public class GroupJson : BaseJsonResult
    {        /// <summary>
        /// 分组id，由微信分配        /// </summary>
        public int id { get; set; }        /// <summary>
        /// 分组名字，UTF8编码        /// </summary>
        public string name { get; set; }
    }

2. Erhalten Sie das Token des AIP-Anrufers

Bei der Entwicklung der WeChat-API müssen wir oft ein AccessToken übergeben Dies ist eine Zeichenfolge, die den Aufrufer unterscheidet und Sitzungsinformationen aufzeichnet. Bevor wir uns mit der gesamten API-Entwicklung befassen, müssen wir diesen Zugriffskontrollparameter gut verstehen.

Die Definition dieses Objekts können wir der API-Beschreibung von WeChat entnehmen.

access_token ist das weltweit eindeutige Ticket des öffentlichen Kontos. Das öffentliche Konto muss beim Aufruf jeder Schnittstelle access_token verwenden. Unter normalen Umständen ist access_token 7200 Sekunden lang gültig. Eine wiederholte Erfassung führt dazu, dass das letzte access_token ungültig wird. Da die Anzahl der API-Aufrufe zum Abrufen von access_token sehr begrenzt ist, wird empfohlen, dass Entwickler access_token global speichern und aktualisieren. Eine häufige Aktualisierung von access_token begrenzt API-Aufrufe und beeinträchtigt ihr eigenes Geschäft.

Gemäß der obigen Definition können wir sehen, dass es sich um einen Parameter handelt, der mit der Identität und der Sitzungszeit zusammenhängt, und es gibt eine Grenze für die Häufigkeit, mit der er generiert werden kann, also wir müssen Es wird zwischengespeichert und wiederverwendet Bevor die Sitzung abläuft, sollten wir diesen Parameter so oft wie möglich wiederverwenden, um wiederholte Anforderungen zu vermeiden, den Serverdruck zu erhöhen und die Anrufzeit zu erhöhen.

Ich habe eine Methode zum Erstellen und Generieren eines zugehörigen Zugriffstokens definiert, die die Funktion des Zwischenspeicherns hat, aber wie sie zwischengespeichert und verwendet wird, ist für den Aufruf meiner API transparent. Wenn wir sie verwenden, rufen Sie sie einfach auf Es.

        /// 获取凭证接口        /// </summary>
        /// <param name="appid">第三方用户唯一凭证</param>
        /// <param name="secret">第三方用户唯一凭证密钥，既appsecret</param>
        string GetAccessToken(string appid, string secret);

Der Cache basiert hauptsächlich auf MemoryCache, einer in .NET4 hinzugefügten Klassenbibliothek. Dies ist eine sehr gute Cache-Klasse.

Mein Operationsimplementierungscode zum Erhalten von AccessToken lautet wie folgt.

        /// <summary>
        /// 获取每次操作微信API的Token访问令牌        /// </summary>
        /// <param name="appid">应用ID</param>
        /// <param name="secret">开发者凭据</param>
        /// <returns></returns>
        public string GetAccessToken(string appid, string secret)
        {            //正常情况下access_token有效期为7200秒,这里使用缓存设置短于这个时间即可
            string access_token = MemoryCacheHelper.GetCacheItem<string>("access_token", delegate()
                {                    string grant_type = "client_credential";                    var url = string.Format("http://www.php.cn/{0}&appid={1}&secret={2}",
                                            grant_type, appid, secret);

                    HttpHelper helper = new HttpHelper();                    string result = helper.GetHtml(url);                    string regex = "\"access_token\":\"(?<token>.*?)\"";
                    string token = CRegex.GetText(result, regex, "token");                    return token;
                },                new TimeSpan(0, 0, 7000)//7000秒过期            );            return access_token;            
        }

Da wir wissen, dass AccessToken standardmäßig in 7200 Sekunden abläuft, verwenden wir den Cache so oft wie möglich, um seinen Wert während dieses Zeitraums aufzuzeichnen Wenn diese Zeit überschritten wird, erhält diese Methode automatisch einen neuen Wert für uns, wenn wir sie aufrufen.

3. Rufen Sie die Liste der folgenden Benutzer ab.

Mit einem Pull-API-Aufruf können Sie die OpenIDs von bis zu 10.000 Followern abrufen mehrere Möglichkeiten, Bedürfnisse zu erfüllen. Die Schnittstellendefinition von WeChat lautet wie folgt.

http-Anfragemethode: GET (bitte verwenden Sie das https-Protokoll)
http://www.php.cn/

这个接口返回的数据是

{"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}

根据返回的Json数据定义，我们还需要定义两个实体类，用来存放返回的结果。

    /// <summary>
    /// 获取关注用户列表的Json结果    /// </summary>
    public class UserListJsonResult : BaseJsonResult
    {        /// <summary>
        /// 关注该公众账号的总用户数        /// </summary>
        public int total { get; set; }        /// <summary>
        /// 拉取的OPENID个数，最大值为10000        /// </summary>
        public int count { get; set; }        /// <summary>
        /// 列表数据，OPENID的列表        /// </summary>
        public OpenIdListData data { get; set; }        /// <summary>
        /// 拉取列表的后一个用户的OPENID        /// </summary>
        public string next_openid { get; set; }
    }    /// <summary>
    /// 列表数据，OPENID的列表    /// </summary>
    public class OpenIdListData
    {        /// <summary>
        /// OPENID的列表        /// </summary>
        public List<string> openid { get; set; }
    }

为了获取相关的用户信息，我定义了一个接口，用来获取用户的信息，接口定义如下所示。

    /// <summary>
    /// 微信用户管理的API接口    /// </summary>
    public interface IUserApi
    {        /// <summary>
        /// 获取关注用户列表        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="nextOpenId">第一个拉取的OPENID，不填默认从头开始拉取</param>
        /// <returns></returns>
        List<string> GetUserList(string accessToken, string nextOpenId = null);        /// <summary>
        /// 获取用户基本信息        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="openId">普通用户的标识，对当前公众号唯一</param>
        /// <param name="lang">返回国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语</param>
        UserJson GetUserDetail(string accessToken, string openId, Language lang = Language.zh_CN);

然后在实现类里面，我们分别对上面两个接口进行实现，获取用户列表信息如下所示。

        /// <summary>
        /// 获取关注用户列表        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="nextOpenId">第一个拉取的OPENID，不填默认从头开始拉取</param>
        /// <returns></returns>
        public List<string> GetUserList(string accessToken, string nextOpenId = null)
        {
            List<string> list = new List<string>();            string url = string.Format("http://www.php.cn/{0}", accessToken);            if (!string.IsNullOrEmpty(nextOpenId))
            {
                url += "&next_openid=" + nextOpenId;
            }

            UserListJsonResult result = JsonHelper<UserListJsonResult>.ConvertJson(url);            if (result != null && result.data != null)
            {
                list.AddRange(result.data.openid);
            }            return list;
        }

我们看到，转换的逻辑已经放到了JsonHelper里面去了，这个辅助类里面分别对数值进行了获取内容，验证返回值，然后转换正确实体类几个部分的操作。

获取内容，通过辅助类HttpHelper进行，这个在我的公用类库里面，里面的逻辑主要就是通过HttpRequest进行数据的获取操作，不在赘述。

HttpHelper helper = new HttpHelper();string content = helper.GetHtml(url);

由于返回的内容，我们需要判断它是否正确返回所需的结果，如果没有，抛出自定义的相关异常，方便处理，具体如下所示。

        /// <summary>
        /// 检查返回的记录，如果返回没有错误，或者结果提示成功，则不抛出异常        /// </summary>
        /// <param name="content">返回的结果</param>
        /// <returns></returns>
        private static bool VerifyErrorCode(string content)
        {            if (content.Contains("errcode"))
            {
                ErrorJsonResult errorResult = JsonConvert.DeserializeObject<ErrorJsonResult>(content);                //非成功操作才记录异常，因为有些操作是返回正常的结果（{"errcode": 0, "errmsg": "ok"}）
                if (errorResult != null && errorResult.errcode != ReturnCode.请求成功)
                {                    string error = string.Format("微信请求发生错误！错误代码：{0}，说明：{1}", (int)errorResult.errcode, errorResult.errmsg);
                    LogTextHelper.Error(errorResult);                    throw new WeixinException(error);//抛出错误                }
            }            return true;
        }

然后转换为相应的格式，就是通过Json.NET的类库进行转换。

            T result = JsonConvert.DeserializeObject<T>(content);            return result;

这样我们就可以在ConvertJson函数实体里面，完整的进行处理和转换了，转换完整的函数代码如下所示。

    /// 

    /// Json字符串操作辅助类    /// 
    public class JsonHelper where T : class, new()
    {        /// <summary>
        /// 检查返回的记录，如果返回没有错误，或者结果提示成功，则不抛出异常        /// </summary>
        /// <param name="content">返回的结果</param>
        /// <returns></returns>
        private static bool VerifyErrorCode(string content)
        {            if (content.Contains("errcode"))
            {
                ErrorJsonResult errorResult = JsonConvert.DeserializeObject<ErrorJsonResult>(content);                //非成功操作才记录异常，因为有些操作是返回正常的结果（{"errcode": 0, "errmsg": "ok"}）
                if (errorResult != null && errorResult.errcode != ReturnCode.请求成功)
                {                    string error = string.Format("微信请求发生错误！错误代码：{0}，说明：{1}", (int)errorResult.errcode, errorResult.errmsg);
                    LogTextHelper.Error(errorResult);                    throw new WeixinException(error);//抛出错误                }
            }            return true;
        }        /// 

        /// 转换Json字符串到具体的对象        /// 
        /// 返回Json数据的链接地址
        /// 
        public static T ConvertJson(string url)
        {
            HttpHelper helper = new HttpHelper();            string content = helper.GetHtml(url);
            VerifyErrorCode(content);

            T result = JsonConvert.DeserializeObject<T>(content);            return result;
        }
}

调用这个API的界面层代码如下所示（测试代码）

            IUserApi userBLL = new UserApi();
            List<string> userList = userBLL.GetUserList(token)

 

4、获取用户详细信息

上面的获取列表操作，相对比较简单，而且不用POST任何数据，因此通过Get协议就能获取到所需的数据。

本小节继续介绍获取用户详细信息的操作，这个操作也是通过GET协议就可以完成的。

这个API的调用定义如下所示：

http请求方式: GET
https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

通过传入一个OpenId，我们就能很好获取到用户的相关信息了。

前面小节我们已经定义了它的接口，说明了传入及返回值，根据定义，它的实现函数如下所示。

        /// <summary>
        /// 获取用户基本信息        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="openId">普通用户的标识，对当前公众号唯一</param>
        /// <param name="lang">返回国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语</param>
        public UserJson GetUserDetail(string accessToken, string openId, Language lang = Language.zh_CN)
        {            string url = string.Format("http://www.php.cn/{0}&openid={1}&lang={2}",
                   accessToken, openId, lang.ToString());

            UserJson result = JsonHelper<UserJson>.ConvertJson(url);            return result;
        }

最后，我们结合获取用户列表和获取用户详细信息的两个API，我们看看调用的代码（测试代码）。

        private void btnGetUsers_Click(object sender, EventArgs e)
        {
            IUserApi userBLL = new UserApi();
            List<string> userList = userBLL.GetUserList(token);            foreach (string openId in userList)
            {
                UserJson userInfo = userBLL.GetUserDetail(token, openId);                if (userInfo != null)
                {                    
                    string tips = string.Format("{0}:{1}", userInfo.nickname, userInfo.openid);
                    Console.WriteLine(tips);
                }
            }
        }

 

更多C#开发微信门户及应用(4)--关注用户列表及详细信息管理 相关文章请关注PHP中文网！