你说得非常对，这里其实涉及两类接口，性质完全不同：

一、需要域名（微信服务器主动推送）

这类接口是微信服务器向你的服务器发请求，所以你的程序必须能被外网访问：

这些情况下微信服务器需要能访问到你的 URL，所以必须配置：

• 外网域名（如 2l1941590s.imwork.net）
• 或内网穿透工具（花生壳、ngrok、frp 等）

这也是为什么之前要在测试账号里配接口地址、配网页授权回调域名的原因。

二、不需要域名（主动调用微信 API）

这类接口是你的服务器主动请求微信服务器，微信不会反向访问你，所以完全不需要外网可达：

这些接口本质上就是 HTTP POST/GET 请求微信的 API 服务器，跟你在浏览器里访问一个网址没区别。

本地调试方式

所以你可以直接在本地用 localhost 或 127.0.0.1 跑项目，直接调用这些接口：

// 本地直接调试，不需要域名
public ActionResult TestGetToken()
{
    var token = GetAccessToken(); // 缓存版，7200秒有效
    return Content(token);
}

public ActionResult TestGetUserList()
{
    var url = $"https://api.weixin.qq.com/cgi-bin/user/get?access_token={GetAccessToken()}";
    var json = HtmlHelper.HttpGet(url);
    return Content(json);
}

public ActionResult TestCreateMenu()
{
    // 创建菜单，本地直接发请求即可
    var handler = new MenuCreateHandle();
    var result = handler.DoPost<dynamic>();
    return Json(result);
}

访问 http://localhost:端口号/home/TestGetToken 就能直接调通。

实际开发建议

调试技巧

1. Token 缓存后本地调试更高效：配合上一节课的 CacheOrLoad 方法，Token 两小时内不重复请求，本地调试基本秒响应。
2. 用 Postman 也能直接测：这些 API 本质上就是 HTTPS 请求，拿到 access_token 后，Postman 里直接填参数就能调。
3. 区分两类接口写代码：可以把主动调用微信 API 的逻辑封装成 Service 类，不依赖 HttpContext，方便本地单元测试。

之前的项目中，每次都去微信服务器获取新的 AccessToken，这样肯定不好。微信服务器返回的 Token 有效期是 7200 秒（2 小时），在这期间 Token 都是有效的，没必要每次都重新获取，频繁调用也会影响程序性能。

我们可以通过 ASP.NET 缓存（Cache）​ 把第一次获取到的 Token 存起来，设置 绝对过期时间​ 为 7200 秒，到期自动失效，下次再重新获取。

为什么用绝对过期而不是滑动过期？

• 绝对过期（Absolute Expiration）：从加入缓存那一刻起，到指定时间点就过期，不管期间有没有被访问。正好契合微信 Token 的 7200 秒有效期。
• 滑动过期（Sliding Expiration）：每次访问缓存就刷新过期时间，这会导致 Token 永远不过期，但微信服务器那边其实已经失效了，不能用。

所以这里使用 System.Web.Caching.Cache.NoSlidingExpiration 禁用滑动过期，配合 DateTime.Now.AddSeconds(7200) 实现绝对过期。

缓存获取/加载通用方法

private static object _lock = new object();

private static T CacheOrLoad<T>(string key, Func<T> action)
{
    T token = default(T);
    lock (_lock)
    {
        // 1. 先从缓存里取
        token = (T)System.Web.HttpRuntime.Cache.Get(key);
        if (token == null)
        {
            // 2. 缓存里没有，调用委托去微信服务器获取新 token
            token = action();
            // 3. 加入缓存，绝对过期时间 7200 秒，非滑动过期
            System.Web.HttpRuntime.Cache.Add(
                key,
                token,
                null,
                DateTime.Now.AddSeconds(7200),
                System.Web.Caching.Cache.NoSlidingExpiration,
                System.Web.Caching.CacheItemPriority.Default,
                null
            );
        }
    }
    return token;
}

调用示例

public static string GetAccessToken()
{
    return CacheOrLoad<string>("Token_KEY", () =>
    {
        // 这里实际请求微信服务器获取 token
        // 伪代码：return HttpGet("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + appid + "&secret=" + secret);
        return "xxxdsfstirjflds;fjdsoifdslfdsf"; // 请求微信服务器获取token
    });
}

控制台测试程序

static void Main(string[] args)
{
    var result = CacheOrLoad("Token_KEY", () =>
    {
        return "xxxdsfstirjflds;fjdsoifdslfdsf"; // 请求微信服务器获取token
    });

    Console.WriteLine(result);
    Console.ReadKey();
}

应用到现有项目中的要点

1. 加锁：使用 lock (_lock) 防止并发时多个请求同时去微信服务器取 Token，避免短时间内多次调用接口被限频。
2. 缓存键唯一：不同公众号、不同用途的 Token 用不同的 key，比如 "Token_KEY"、"WebAccessToken_KEY" 等。
3. 异常处理：如果获取 Token 失败（网络异常、appid/secret 错误），不应该把错误结果写入缓存，可以在 action 里抛异常或返回 null，在 CacheOrLoad 里判断 token 有效性再决定是否缓存。
4. 网页授权 access_token 也适用：网页授权的 access_token 有效期也是 7200 秒，同样可以用这个模式缓存，但注意它的 key 要区分 openid 或 session。

改进版（带有效性校验）

private static T CacheOrLoad<T>(string key, Func<T> action) where T : class
{
    lock (_lock)
    {
        var token = System.Web.HttpRuntime.Cache.Get(key) as T;
        if (token == null)
        {
            token = action();
            if (token != null)
            {
                System.Web.HttpRuntime.Cache.Add(
                    key,
                    token,
                    null,
                    DateTime.Now.AddSeconds(7200),
                    System.Web.Caching.Cache.NoSlidingExpiration,
                    System.Web.Caching.CacheItemPriority.Default,
                    null
                );
            }
        }
        return token;
    }
}

这样改造后，Token 在 2 小时内只会向微信服务器请求一次，大幅减少不必要的网络调用，也符合微信接口调用的最佳实践。

首先请注意，这里通过 code 换取的是一个特殊的网页授权 access_token，与基础支持中的 access_token（用于调用其他接口）不同。

公众号可通过下述接口来获取网页授权 access_token。如果网页授权的作用域为 snsapi_base，则本步骤中获取到网页授权 access_token 的同时，也获取到了 openid，snsapi_base 式的网页授权流程即到此为止。

安全提醒：由于公众号的 secret 和获取到的 access_token 安全级别都非常高，必须只保存在服务器，不允许传给客户端。后续刷新 access_token、通过 access_token 获取用户信息等步骤，也必须从服务器发起。

请求方法

获取 code 后，请求以下链接获取 access_token：

https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code

参数说明

返回说明

正确时返回的 JSON 数据包如下：

{
  "access_token": "ACCESS_TOKEN",
  "expires_in": 7200,
  "refresh_token": "REFRESH_TOKEN",
  "openid": "OPENID",
  "scope": "SCOPE"
}

错误时微信会返回 JSON 数据包如下（示例为 Code 无效错误）：

{"errcode":40029,"errmsg":"invalid code"}

在 Manage 控制器中获取 code 并换取网页授权 access_token

用户同意授权后，微信会跳转回 redirect_uri，并附带 code 和 state 参数。我们在 Manage 控制器中接收这个 code，然后调用接口换取网页授权 access_token。

public class HomeController : Controller
{
    public ActionResult Manage(string code, string state)
    {
        if (string.IsNullOrEmpty(code))
        {
            return Content("未获取到授权code");
        }

        // 第一步：用 code 换取网页授权 access_token
        var url = string.Format(
            "https://api.weixin.qq.com/sns/oauth2/access_token?appid={0}&secret={1}&code={2}&grant_type=authorization_code",
            "wx51ebd98e1d633db6",
            "42a5564582bda88104367ea5851c9265",
            code
        );

        var json = HtmlHelper.HttpGet(url);
        var tokenResult = JsonHelper.DeserializeJsonToObject<dynamic>(json);

        // 判断是否返回错误
        if (tokenResult.errcode != null)
        {
            return Content("获取网页授权access_token失败：" + tokenResult.errmsg);
        }

        // 拿到网页授权 access_token 和 openid
        string webAccessToken = tokenResult.access_token;
        string openid = tokenResult.openid;
        string refreshToken = tokenResult.refresh_token;
        string scope = tokenResult.scope;

        // 可以将 webAccessToken、openid 存入 Session 或缓存，供后续使用
        Session["WebAccessToken"] = webAccessToken;
        Session["OAuthOpenId"] = openid;

        // 第二步（下一步）：通过 webAccessToken 和 openid 获取用户信息
        // 这里先返回获取到的 token 信息，验证流程是否走通
        return Json(new
        {
            webAccessToken,
            openid,
            scope,
            tip = "接下来可以用 webAccessToken + openid 调用获取用户信息接口"
        }, JsonRequestBehavior.AllowGet);
    }
}

关键注意事项

1. code 只能使用一次，5 分钟未用自动过期。调试时不要重复刷新同一个 code 的页面。
2. 网页授权 access_token 与基础 access_token 是两套东西，不要混用。基础 access_token 用于模板消息、自定义菜单等接口；网页授权 access_token 仅用于获取用户信息。
3. secret 和 access_token 不要传到客户端，所有换取和刷新操作都在服务器端完成。
4. 如果 scope 是 snsapi_base，到这一步就已经拿到了 openid，不需要再走获取用户信息的步骤。
5. 如果 scope 是 snsapi_userinfo，接下来还需要用 webAccessToken + openid 调用获取用户基本信息接口，这个我们下一步再实现。

模板消息里点击详情可以跳转到某个页面，但模板本身是微信内部固定好的，不是随便设计。

如果用户在微信客户端中访问第三方网页，公众号可以通过微信网页授权机制，来获取用户基本信息，进而实现业务逻辑。

网页授权回调域名说明

1. 在微信公众号请求用户网页授权之前，开发者需要先到公众平台官网中的“开发 – 接口权限 – 网页服务 – 网页帐号 – 网页授权获取用户基本信息”里，修改授权回调域名。这里填写的是域名（字符串），不是 URL，因此请勿加 http:// 等协议头。
2. 授权回调域名配置规范为全域名。比如需要网页授权的域名为：www.qq.com，配置以后此域名下面的页面 http://www.qq.com/music.html 、 http://www.qq.com/login.html 都可以进行 OAuth2.0 鉴权；但 http://pay.qq.com 、 http://music.qq.com 、 http://qq.com 无法进行 OAuth2.0 鉴权。
3. 如果公众号登录授权给了第三方开发者来进行管理，则不必做任何设置，由第三方代替公众号实现网页授权即可。

两种 scope 的区别

1. 以 snsapi_base 为 scope 发起的网页授权，用来获取进入页面的用户的 openid，是静默授权并自动跳转到回调页。用户感知就是直接进入了回调页（往往是业务页面）。
2. 以 snsapi_userinfo 为 scope 发起的网页授权，用来获取用户的基本信息。这种授权需要用户手动同意，用户同意过后，无须关注公众号，也可在授权后获取该用户的基本信息。
3. 用户管理类接口中的“获取用户基本信息接口”，是在用户和公众号产生消息交互或关注后事件推送后，才能根据用户 OpenID 来获取用户基本信息。这个接口，包括其他微信接口，都需要该用户（openid）关注了公众号后，才能调用成功。

网页授权 access_token 和普通 access_token 的区别

1. 微信网页授权是通过 OAuth2.0 机制实现的，用户授权给公众号后，公众号可以获取到网页授权特有的接口调用凭证（网页授权 access_token），通过它可以进行授权后接口调用，如获取用户基本信息。
2. 其他微信接口，需要通过基础支持中的“获取 access_token”接口来获取普通 access_token 调用。

UnionID 机制

1. 网页授权获取用户基本信息也遵循 UnionID 机制。如果开发者有多个公众号，或在公众号、移动应用之间统一用户帐号，需要前往微信开放平台（open.weixin.qq.com）绑定公众号后，才能利用 UnionID 机制满足需求。
2. UnionID 机制作用：如果开发者拥有多个移动应用、网站应用和公众帐号，可通过用户基本信息中的 unionid 区分用户唯一性。同一用户，对同一个微信开放平台下的不同应用（移动应用、网站应用和公众帐号），unionid 是相同的。

特殊场景下的静默授权

1. 以 snsapi_base 为 scope 的网页授权，是静默授权，用户无感知。
2. 对于已关注公众号的用户，如果从公众号会话或者自定义菜单进入本公众号的网页授权页，即使是 scope 为 snsapi_userinfo，也是静默授权，用户无感知。

网页授权流程

1. 引导用户进入授权页面同意授权，获取 code
2. 通过 code 换取网页授权 access_token（与基础支持中的 access_token 不同）
3. 如果需要，开发者可以刷新网页授权 access_token，避免过期
4. 通过网页授权 access_token 和 openid 获取用户基本信息（支持 UnionID 机制）

配置授权回调域名

在测试账号管理页面中配置网页授权回调域名。

修改菜单地址为网页授权地址

secondButton.Add(new
{
    type = "view",
    name = "管理后台",
    url = string.Format(
        "https://open.weixin.qq.com/connect/oauth2/authorize?appid={0}&redirect_uri={1}&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect",
        APPID,
        "http%3a%2f%2f2l1941590s.imwork.net%2fhome%2fmanage")
});

记得要对回调地址进行 URL 编码：

http%3a%2f%2f2l1941590s.imwork.net%2fhome%2fmanage

用户同意授权后

如果用户同意授权，页面将跳转至：

redirect_uri/?code=CODE&state=STATE

code 说明：code 作为换取 access_token 的票据，每次用户授权带上的 code 都不一样，code 只能使用一次，5 分钟未被使用自动过期。

在上一节课中，我们获取到了当前公众号的模板 ID，接下来就可以使用这个模板来发送模板消息。

接口说明

HTTP 请求方式：POST

https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

替换模板占位符时，还可以为每个字段设置显示颜色。

Handler 实现

public class TemplateSendHandle : WeiXinHandlerBase, IWeiXinHandler
{
    private string url = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token={0}";

    public T DoGet<T>(params string[] param) where T : class
    {
        throw new NotImplementedException();
    }

    public T DoPost<T>(params string[] param) where T : class
    {
        var uploadUrl = string.Format(url, accessTokenInfo.access_token);
        var user = new UserGetHandler().DoGet<UserInfo>();

        var post = new
        {
            touser = user.data.openid[0], // 发给第一个人
            template_id = "coA2OijGsDxN3b2i48D0vaPLd5BraRQnDYcJ8MazzAc",
            url = "http://www.bamn.cn",
            data = new
            {
                first = new { value = "恭喜你购买成功！", color = "#173177" },
                orderMoneySum = new { value = "1000！", color = "#183177" },
                orderProductName = new { value = "苹果电脑 MACBOOK PRO", color = "#173177" },
                Remark = new { value = "备注，分12期还款", color = "#173377" }
            }
        };

        var json = JsonHelper.SerializeObject(post);
        var resultjson = HtmlHelper.HttpPost(uploadUrl, json);
        var output = JsonHelper.DeserializeJsonToObject<T>(resultjson);
        return output;
    }
}

控制器中调用

public ActionResult TemplateSend()
{
    var result = new TemplateSendHandle().DoPost<dynamic>();
    return Json(result);
}

调用测试

访问地址：

http://xxxxx.imwork.net/home/TemplateSend

返回结果：

{"errcode":0,"errmsg":"ok","msgid":451307458980315137}

errcode 为 0 表示发送成功。

上面配置完行业以后，就可以获取该行业对应的模板。通过获取模板内容，可以看到里面有很多占位符，后续发送模板消息时再填充这些数据。

例如模板内容：

{{result.DATA}}

领奖金额:{{withdrawMoney.DATA}}
领奖   时间:{{withdrawTime.DATA}}
银行信息:{{cardInfo.DATA}}
到账时间: {{arrivedTime.DATA}}
{{remark.DATA}}

这些 {{xxx.DATA}} 就是模板占位符，都可以在发送模板消息时配置具体值。

获取模板列表接口

获取已添加至帐号下的所有模板列表，也可以在微信公众平台后台查看。微信同样提供了接口调用方式。

接口调用请求说明：

HTTP 请求方式：GET

https://api.weixin.qq.com/cgi-bin/template/get_all_private_template?access_token=ACCESS_TOKEN

Handler 实现

public class AllPrivateTemplateHandler : WeiXinHandlerBase, IWeiXinHandler
{
    private string url = "https://api.weixin.qq.com/cgi-bin/template/get_all_private_template?access_token={0}";

    public T DoGet<T>(params string[] param) where T : class
    {
        url = string.Format(url, accessTokenInfo.access_token);
        var json = HtmlHelper.HttpGet(url);
        var output = JsonHelper.DeserializeJsonToObject<T>(json);
        return output;
    }

    public T DoPost<T>(params string[] param) where T : class
    {
        throw new System.NotImplementedException();
    }
}

控制器中调用

public ActionResult GetAllPrivateTemplate()
{
    var result = new AllPrivateTemplateHandler().DoGet<dynamic>();
    return Json(result);
}

返回结果示例

{
  "template_list": [
    {
      "template_id": "coA2OijGsDxN3b2i48D0vaPLd5BraRQnDYcJ8MazzAc",
      "title": "订单支付成功",
      "primary_industry": "IT科技",
      "deputy_industry": "互联网|电子商务",
      "content": "{{first.DATA}}\n\n支付金额：{{orderMoneySum.DATA}}\n商品信息：{{orderProductName.DATA}}\n{{Remark.DATA}}",
      "example": "我们已收到您的货款，开始为您打包商品，请耐心等待: )\n支付金额：30.00元\n商品信息：我是商品名字\n\n如有问题请致电400-828-1878或直接在微信留言，小易将第一时间为您服务！"
    }
  ]
}

拿到 template_id 和模板里的 {{xxx.DATA}} 占位符后，就可以在发送模板消息时按字段填充数据。

模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合要求的服务场景中，如信用卡刷卡通知、商品购买成功通知等。不支持广告等营销类消息，以及其他所有可能对用户造成骚扰的消息。

文档地址：

https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751277

设置所属行业

设置行业可以在微信公众平台后台完成，每月可修改行业 1 次。帐号只能使用所属行业中相关的模板。为方便第三方开发者，微信也提供通过接口调用修改账号所属行业的方式。

接口调用请求说明：

HTTP 请求方式：POST

https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=ACCESS_TOKEN

POST 数据示例：

{
  "industry_id1": "1",
  "industry_id2": "4"
}

参数说明：

说白了，不同行业有不同的模板格式，需要通过接口设置公众号所属行业。具体行业代码可参考上面的文档地址。

Handler 实现

public class ApiSetIndustryHandler : WeiXinHandlerBase, IWeiXinHandler
{
    private string url = "https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token={0}";

    public T DoGet<T>(params string[] param) where T : class
    {
        throw new NotImplementedException();
    }

    public T DoPost<T>(params string[] param) where T : class
    {
        var para = new
        {
            industry_id1 = "1",
            industry_id2 = "10"
        };

        var json = JsonHelper.SerializeObject(para);
        url = string.Format(url, accessTokenInfo.access_token);

        var content = HtmlHelper.HttpPost(url, json);
        return JsonHelper.DeserializeJsonToObject<T>(content);
    }
}

控制器中调用

public ActionResult ApiSetIndustry()
{
    var result = new ApiSetIndustryHandler().DoPost<dynamic>();
    return Json(result);
}

访问测试

http://xxxxx.imwork.net/home/ApiSetIndustry

返回：

{"errcode":43100,"errmsg":"change template too frequently hint: [kLqX706961961]"}

原因是：公众号所属行业一个月只能设置一次。

当用户关注或取消关注公众号时，微信会推送一条事件消息到开发者填写的 URL 接口。我们可以捕捉这个事件，判断是订阅还是取消订阅，从而下发欢迎消息或做帐号解绑等操作。

为保护用户数据隐私，开发者收到用户取消关注事件时需要删除该用户的所有信息。

接口说明

文档地址：

https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140454

推送 XML 数据包示例：

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[FromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[subscribe]]></Event>
</xml>

参数说明：

控制器中处理关注/取消关注事件

在 Common 方法的 event 分支中增加 subscribe 和 unsubscribe 的判断：

case "event":
    switch (Event.InnerText.ToLower())
    {
        case "click":
            string returnXml2 = string.Format(@"<xml>
                <ToUserName><![CDATA[{0}]]></ToUserName>
                <FromUserName><![CDATA[{1}]]></FromUserName>
                <CreateTime>{2}</CreateTime>
                <MsgType><![CDATA[{3}]]></MsgType>
                <Content><![CDATA[{4}]]></Content>
                </xml>",
                FromUserName.InnerText,
                ToUserName.InnerText,
                OtherUtil.GetTimestamp(DateTime.Now),
                "text",
                "请不要点击。");
            return this.Content(returnXml2);

        case "subscribe":
            string returnXml3 = string.Format(@"<xml>
                <ToUserName><![CDATA[{0}]]></ToUserName>
                <FromUserName><![CDATA[{1}]]></FromUserName>
                <CreateTime>{2}</CreateTime>
                <MsgType><![CDATA[{3}]]></MsgType>
                <Content><![CDATA[{4}]]></Content>
                </xml>",
                FromUserName.InnerText,
                ToUserName.InnerText,
                OtherUtil.GetTimestamp(DateTime.Now),
                "text",
                "欢迎关注。");
            return this.Content(returnXml3);

        case "unsubscribe":
            // 这里应该做一些清理用户信息的操作，发信息给它已经没有用了
            break;

        default:
            break;
    }
    break;

当用户点击某个菜单后，微信服务器会发送一个 XML 文档到我们服务器上配置的接口地址（即之前配置的 Common 接口）。我们可以解析这个 XML 文档来获取点击事件信息。

自定义菜单事件推送说明

用户点击自定义菜单后，微信会把点击事件推送给开发者。注意：点击菜单弹出子菜单不会产生上报。

点击菜单拉取消息时的事件推送 XML 示例：

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[FromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[CLICK]]></Event>
  <EventKey><![CDATA[EVENTKEY]]></EventKey>
</xml>

参数说明：

其中 EventKey 对应之前新增菜单时配置的 key，例如 V1001_TODAY_MUSIC。通过这个值可以判断是哪个按钮被点击了。

控制器中处理菜单点击事件

在 Common 方法的 POST 分支中增加对 event 类型的处理：

[HttpPost]
public IActionResult Common()
{
    XmlDocument xmldoc = new XmlDocument();
    xmldoc.Load(Request.Body);

    XmlNode MsgType = xmldoc.SelectSingleNode("/xml/MsgType");
    XmlNode ToUserName = xmldoc.SelectSingleNode("/xml/ToUserName");
    XmlNode FromUserName = xmldoc.SelectSingleNode("/xml/FromUserName");
    XmlNode Content = xmldoc.SelectSingleNode("/xml/Content");
    XmlNode Event = xmldoc.SelectSingleNode("/xml/Event");

    switch (MsgType.InnerText)
    {
        case "text":
            var ret = "你好吗";
            if (Content.InnerText.Contains("天气"))
            {
                ret = "21摄氏度";
            }
            string returnXml = string.Format(@"<xml>
                <ToUserName><![CDATA[{0}]]></ToUserName>
                <FromUserName><![CDATA[{1}]]></FromUserName>
                <CreateTime>{2}</CreateTime>
                <MsgType><![CDATA[{3}]]></MsgType>
                <Content><![CDATA[{4}]]></Content>
                </xml>",
                FromUserName.InnerText,
                ToUserName.InnerText,
                OtherUtil.GetTimestamp(DateTime.Now),
                "text",
                ret);
            return this.Content(returnXml);

        case "event":
            switch (Event.InnerText.ToLower())
            {
                case "click":
                    string returnXml2 = string.Format(@"<xml>
                        <ToUserName><![CDATA[{0}]]></ToUserName>
                        <FromUserName><![CDATA[{1}]]></FromUserName>
                        <CreateTime>{2}</CreateTime>
                        <MsgType><![CDATA[{3}]]></MsgType>
                        <Content><![CDATA[{4}]]></Content>
                        </xml>",
                        FromUserName.InnerText,
                        ToUserName.InnerText,
                        OtherUtil.GetTimestamp(DateTime.Now),
                        "text",
                        "请不要点击。");
                    return this.Content(returnXml2);

                default:
                    break;
            }
            break;

        default:
            break;
    }

    return this.Content("");
}

公众号底部会显示菜单栏，这些菜单栏可以在微信公众平台后台管理，也可以使用公众平台提供的接口进行管理，调用 POST 方法把菜单的 JSON 文本推送到微信服务器即可。

接口说明

文档地址：

https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141013

自定义菜单规则：

• 最多包括 3 个一级菜单，每个一级菜单最多包含 5 个二级菜单
• 一级菜单最多 4 个汉字，二级菜单最多 7 个汉字，多出来的部分以”…”代替
• 自定义菜单接口可实现多种类型按钮：click、view 等

HTTP 请求方式：POST（请使用 https 协议）

https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN

每次创建或修改菜单时，需要把完整的菜单结构全部发送过去。

添加 MenuCreateHandle

public class MenuCreateHandle : WeiXinHandlerBase, IWeiXinHandler
{
    private string url = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token={0}";

    public T DoGet<T>(params string[] param) where T : class
    {
        throw new NotImplementedException();
    }

    public T DoPost<T>(params string[] param) where T : class
    {
        var uploadUrl = string.Format(url, accessTokenInfo.access_token);
        // view表示网页类型，click表示点击类型，miniprogram表示小程序类型
        var firstButton = new List<object>();
        firstButton.Add(new { type = "click", name = "课程", key = "V1001_TODAY_MUSIC" });

        var secondButton = new List<object>();
        secondButton.Add(new { type = "view", name = "管理后台", url = "http://www.bamn.cn" });
        secondButton.Add(new { type = "click", name = "赞一下我们", key = "V1001_GOOD" });

        firstButton.Add(new { type = "click", name = "管理", sub_button = secondButton });

        var input = new { button = firstButton };
        var json = JsonHelper.SerializeObject(input);
        var resultjson = HtmlHelper.HttpPost(uploadUrl, json);
        var output = JsonHelper.DeserializeJsonToObject<T>(resultjson);
        return output;
    }
}

控制器中调用

public ActionResult CreateMenu()
{
    var result = new MenuCreateHandle().DoPost<dynamic>();
    return Json(result);
}