微信公众平台开发小记(ASP.NET)

时间:2023-10-02 21:48:08

微信的好东西,提供了很大的平台去发挥,公司最近推出微信公众账号,也接触了一些东西, 最终决定用asp.net来开发服务端程序。

微信公众平台的API很简单,利用XML来规范格式,并且所有的数据都在CDATA中,不会担心 转换的问题,所以开发出一个简单的应用确实是很简单的,难得是结合运营把账号做大。

消息接口指南 中介绍了如何成为开发者:网址接入认证、消息推送和消息回复。

网址接入

想要成为开发者,必须要有自己的服务器,所以就需要网址验证,之后微信服务器推送的消息 都会推送到这个链接。

微信服务器会发送GET请求到你所填写的URL,并附带4个参数:

参数 描述
signature 微信加密签名
timestamp 时间戳
nonce 随机数
echostr 随机字符串

验证的方式为:

加密/校验流程:
1. 将token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行sha1加密
3. 开发者获得加密后的字符串可与signature对比,标识该请求来源于微信

代码为:

[code lang="csharp"]
public bool CheckSign(string signature, string timestamp, string nonce)
{
string[] strs = new string[] {token, timestamp, nonce };
Array.Sort(strs);
string strNew = string.Join("", strs);
strNew = FormsAuthentication.HashPasswordForStoringInConfigFile(strNew, "SHA1");
if (signature == strNew.ToLower())
return true;
return false;
}
[/code]

消息推送

即收取微信服务器推送过来的消息,通常是用户发送、用户关注或者取消关注等,服务端程序可以进行相应的处理。消息分为几种类型,每种类型都有特定的格式,有部分节点是通用的,但都需要解析XML。

解析XML有很多种方式,这里我用的是:

[code lang="csharp"]
public Msg LoadXmlToMsg(string xml)
{
Msg msg = null;
XmlDocument doc = new XmlDocument();
doc.LoadXml(xml);
XmlElement ele = doc.DocumentElement;
XmlNode node = ele.SelectSingleNode("MsgType");
if (node != null)
{
msg = createSonMsg(node.InnerText);
msg.MsgType = node.InnerText;
}
else
{
return null;
}
msg.ToUserName = ele.SelectSingleNode("ToUserName").InnerText;
msg.FromUserName = ele.SelectSingleNode("FromUserName").InnerText;
msg.CreateTime = ele.SelectSingleNode("CreateTime").InnerText;
msg = msg.LoadXmlToMsg(ele, msg);
return msg;
}
[/code]

消息回复

目前消息回复只有三种:文本、音乐和图文。消息回复其实和XML解析类似,只是要生成对应的XML内容,然后再回复回去。

以文本类型回复为例:

[code lang="csharp"]
public override string createXmlFromMsg(Msg msg)
{
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("");
sb.Append("<!--[CDATA[{0}]]-->");
sb.Append("<!--[CDATA[{1}]]-->");
sb.Append("{2}");
sb.Append("<!--[CDATA[text]]-->");
sb.Append("<!--[CDATA[{3}]]-->");
sb.Append("0x0001");
sb.Append("");
string reStr = sb.ToString();
reStr = string.Format(reStr, new string[]{
msg.ToUserName,
msg.FromUserName,
base.ConvertDateTimeInt().ToString(),
((MsgText)msg).Content
});
return reStr;
}
[/code]