C#微信开发文档

C#微信开发文档

开发前准备

微信公众平台链接:

https://mp.weixin.qq.com/cgi-bin/home?t=home/index&lang=zh_CN

开发初期我们使用测试号测试我们的微信功能,微信提供了测试号申请,它具有大部分我们需要的功能

微信公众平台测试号申请网址:

http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login

1:测试号申请申请成功后我们首先要将我们的服务器接入微信接入微信公众平台来进行开发

首先我们配置我们自己的服务器:

I:在本地新建一个项目 ,新建一个页面weixin.aspx

II: 为项目配置主题(不配置服务器会报关于主题配置的错误)

Web.config配置:

<system.web>

<compilation debug="true"  />

<pages theme="Blue">

<controls>

</controls>

</pages>

</system.web>

III:在weixin.aspx写点东西测试一下

IV:发布到服务器上 我们使用的服务器为:略  账号:略  密码:略

注意每次修改后     先编译一次再发布

V: 使用浏览器访问我们的页面

这样就可以将我们的服务器接入微信公众平台:

在微信公众平台测试页我们这样配置URL与Token

这里涉及到一个用户. 微信. 服务器的交互问题:

当用户通过微信提交一个消息(事件)时,先提交到腾讯微信的服务器,然后微信服务器将消息组装为xml格式的消息提交给我们的(开发者)服务者器,这样我们就可以解析这样的消息,然后给予用户反馈

当我们在微信公众平台点击提交按钮的时候,这里是微信公众平台与服务器的交互,我们需要在服务器端验证这个微信测试号(原因:微信客户端需要验证服务器地址的有效性),验证代码在weixin.aspx的pageload事件里  这里是因为当我们加载这个页面时第一次就是加载pageload事件,以下是验证代码(在项目中可以看到具体的代码):

string echoStr = Request.QueryString["echoStr"].ToString();

if (!string.IsNullOrEmpty(echoStr))

{

Valid();//校验签名

}

加判断是因为当微信服务器与开发服务器第一次验证服务器有效性时需要执行Valid(),而普通交互时则不需要验证

当微信平台出现如下图所示时表示配置成功。

2:项目开发代码解释

I: 由于在开发微信中的测试比较难,在服务器端加入了一个记事本文档 我们可以将用户与服务器的交互记录在文档中

(这个函数只能在页面中调用)

/// <summary>

/// 写日志(用于跟踪),可以将想打印出的内容计入一个文本文件里面,便于测试

/// </summary>

public static void WriteLog(string strMemo, HttpServerUtility server)

{

string filename = server.MapPath("~") + @"/logs/log.txt";

//string filename = server.MapPath("logs/log.txt");//在网站项目中建立一个文件夹命名logs(然后在文件夹中随便建立一个web页面文件,避免网站在发布到服务器之后看不到预定文件)

if (!Directory.Exists(server.MapPath("~") + @"/logs/"))

Directory.CreateDirectory(server.MapPath("~") + @"/logs/");

StreamWriter sr = null;

try

{

if (!File.Exists(filename))

{

sr = File.CreateText(filename);

}

else

{

sr = File.AppendText(filename);

}

sr.WriteLine(strMemo);

}

catch

{

}

finally

{

if (sr != null)

sr.Close();

}

}

II:weixin.aspx后台代码

PostInput()方法,将传过来的数据流转化为字节数组

Page_Load事件中Response.Write(amgp.resxml);

这句话就是返回给用户的信息(xml格式)

III:messageHelp  (获取信息的类)

在构造函数中对信息进行处理

public messageHelp(string weixinXML)

{

XmlDocument doc = new XmlDocument();

doc.LoadXml(weixinXML);//读取XML字符串

XmlNodeList NodeList = doc.FirstChild.ChildNodes;

foreach (XmlNode xn in NodeList)

{

XmlElement xe = (XmlElement)xn;

switch (xe.Name)

{

case "ToUserName": ToUserName = xe.InnerText; break;

case "FromUserName": FromUserName = xe.InnerText; break;//用户的openid

case "CreateTime": CreateTime = xe.InnerText; break;//消息创建时间

case "MsgType": MsgType = xe.InnerText; break;//获取的消息类型

case "MsgId": MsgId = xe.InnerText; break;  //获取消息ID

case "Content": TextContent = xe.InnerText; break; //获取文本内容

case "Event": EventType = xe.InnerText; break;//获取事件类型

case "PicUrl": PicUrl = xe.InnerText; break; //获取图片地址

case "EventKey": EventKey = xe.InnerText; break;//获取click事件的键值

case "Latitude": Latitude = xe.InnerText; break;//获取自动上传地理位置   纬度

case "Longitude": Longitude = xe.InnerText; break;//获取自动上传地理位置   经度

case "Location_X": Location_X = xe.InnerText; break;//获取地理位置   纬度

case "Location_Y": Location_Y = xe.InnerText; break;//获取地理位置   经度

default: break;

}

}

对不同的消息类型进行处理:

public void ResponseMsg(string MsgTypeStr)

{

try

{

switch (MsgTypeStr)

{

case "event": resxml = this.ReceiveEvent();

break;

case "text": resxml = this.ReceiveText();

break;

case "location": ; resxml = this.ReceiveLocation();

break;

case "voice": ;

break;

case "video": ;

break;

case "link": ;

break;

case "image": resxml = this.ReceiveImage();

break;

default: resxml = this.ReceiveNothing();

break;

}

}

catch (Exception ex)

{

throw ex;

}

}

具体处理代码我就不在这里粘贴了

补充:时间处理  由于加载消息的xml中时间格式为 时间戳 (定义为从格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数)

所以要转化为北京时间: 代码在 ConvertDateTime()函数

IV:

每个账户都有唯一的appid和appsecret 它们的作用是为了获取access_token的值access_token是公众号的全局唯一票据,公众号调用各接口时都需使用access_token。正常情况下access_token有效期为7200秒,重复获取将导致上次获取的access_token失效。

公众号可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在开发模式中获得(需要已经成为开发者,且帐号没有异常状态)。注意调用所有微信接口时均需使用https协议。

接口调用请求说明

http请求方式: GET

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

参数说明


参数


是否必须


说明


grant_type



获取access_token填写client_credential


appid



第三方用户唯一凭证


secret



第三方用户唯一凭证密钥,既appsecret

返回说明

正常情况下,微信会返回下述JSON数据包给公众号:

{"access_token":"ACCESS_TOKEN","expires_in":7200}


参数


说明


access_token


获取到的凭证


expires_in


凭证有效时间,单位:秒

错误时微信会返回错误码等信息,JSON数据包示例如下(该示例为AppID无效错误):

{"errcode":40013,"errmsg":"invalid appid"}

简单一点理解:我们可以获取access_token  ,在浏览器中输入我们的https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET(这里的appid和appsecret配置在webconfig中)

出现如图中效果说明可以获取成功

我们的后台代码可以获取到每个节点的值:具体参照GetAccessToken(),GetJsonValue()和RequestUrl()这三个方法

V: 自定义菜单的建立

createMenu.ascx控件的后台代码中实现了建立页面的代码  又在weixin.aspx中引用了这个,这样就实现了菜单的建立

菜单的配置在menu.txt中  配置时注意格式

以下为实例:

{

"button":

[

{

"type":"click",

"name":"今日歌曲",

"key":"今日歌曲"

},

{

"type":"view",

"name":"测试页",

"url":"http://jxedu.ecjtu.jx.cn/weixin/测试页.aspx"

},

{

"name":"菜单",

"sub_button":

[

{

"type":"view",

"name":"搜索",

"url":"http://www.soso.com/"

},

{

"type":"view",

"name":"视频",

"url":"http://v.qq.com/"

},

{

"type":"click",

"name":"查看信息",

"key":"查看信息"

}

]

}

]

}

参数说明


参数


是否必须


说明


button



一级菜单数组,个数应为1~3个


sub_button



二级菜单数组,个数应为1~5个


type



菜单的响应动作类型,目前有click、view两种类型


name



菜单标题,不超过16个字节,子菜单不超过40个字节


key


click类型必须


菜单KEY值,用于消息接口推送,不超过128字节


url


view类型必须


网页链接,用户点击菜单可打开链接,不超过256字节

时间: 2024-11-05 22:55:20

C#微信开发文档的相关文章

武汉微信开发文档之微信公众平台开发

武汉微信开发是一门比较复杂的工作,想要做好是比较困难的,所以也就要求武汉微信开发从业者要充分的了解微信开发的知识.下面,我就要介绍一些武汉微信开发文档,这些文档是与微信公众开发有关的,大家可以详细的看一看哦. 开放平台对应的是app里关于微信的开发,比如app里的微信支付账号是开放平台下的.一个开放平台,可以绑定10个公众平台,绑定后会有权限获取unionid. 公众平台对应的是和公众号有关的开发,除了公众号接收消息.菜单等基本功能外,还包括基于公众号的H5相关的开发.微信里.浏览器内的微信支付

微信开发文档

1. 选择功能设置 填写JS安全域名 下载 .....txt.传到服务器上 2.下一步进入基本配置 AppID(应用ID)  wxc8d0f11aba2b1ec0 AppSecret(应用密钥) 0937eb071d48a6b944ccc3e67ad0b25e 3.修改服务器配置 配置令牌 token 开始开发---接入指南 页面最下方 代码示例 下载 wx_sample.php 去开发者中心 进入开发者文档 进入微信网页开发 进入微信JS-SDK开发文档 页面的最下方 示例代码 下载完成后 打

微信开发文档与工具整理

http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=jsapisign http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login&code=0014271b44b24e7c7cd3302f40be1173&state= http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login http://203.195.235.7

微信小程序开发工具&amp;demo下载&amp;开发文档

我们先来看一下微信小程序进去是什么样子,给大家发一波福利Mac破解版:https://yunpan.cn/ckvBbavJRwt25 (提取码:a869)Windows破解版:https://yunpan.cn/ckvMx4hncQSvN (提取码:111a) demo下载:https://yunpan.cn/ckvvQVGgak6tx (提取码:7141) 开发文档:http://notedown.cn/weixin/api/ 开发工具 v0.7百度:mac 版本http://dldir1.q

微信支付 开发文档入口

微信支付 开发文档入口 1.微信支付开发文档入口 包含有,微信刷卡支付,微信公众号支付,扫码支付,APP支付,h5支付,小程序支付开发文档 原文地址:https://www.cnblogs.com/hysen/p/9251241.html

微信-小程序-开发文档-模板消息:templateMessage.getTemplateLibraryById

ylbtech-微信-小程序-开发文档-服务端-模板消息:templateMessage.getTemplateLibraryById 1.返回顶部 1. templateMessage.getTemplateLibraryById 本接口应在服务器端调用,详细说明参见服务端API. 本接口支持云调用.需开发者工具版本 >= 1.02.1904090(最新稳定版下载),wx-server-sdk >= 0.4.0 获取模板库某个模板标题下关键词库 调用方式: HTTPS 调用 云调用 HTTP

歌词音译吧开发文档

韩梦飞沙  韩亚飞  [email protected]  yue31313  han_meng_fei_sha =================================1,中文翻译,对照2,中文发音,对照 歌词列表 从空间日志列表里获取.Tara no9 ..urltara day by day ..url 点击打开 读取日志内容 歌曲 T-ara NO.9 //翻译页面 按钮切换 发音页面//一个页面//嵌入该音乐 播放 暂停.复制歌词 //添加?添加空间日志就OK了. 如果直接连

365小票打印机打印接口开发文档

API开发文档 接口1:打印内容 参数 说明 deviceNo 打印机编号 key 密钥 printContent 打印内容 times 固定传1 调用方式:HTTP POSTURL:http://open.printcenter.cn:8080/addOrder返回结果:JSON字符串 ----------S1小票机返回的结果有如下几种:---------- {"responseCode":0,"msg":"订单添加成功,打印完成","

某小票打印机打印接口开发文档

API开发文档 接口1:打印内容 参数 说明 deviceNo 打印机编号 key 密钥 printContent 打印内容 times 固定传1 调用方式:HTTP POSTURL:http://open.printcenter.cn:8080/addOrder返回结果:JSON字符串 ----------S1小票机返回的结果有如下几种:---------- {"responseCode":0,"msg":"订单添加成功,打印完成","