微信公共开发者文档 阅读笔记

先上效果图：

    作者博客：http://blog.csdn.net/stationxp  
    作者微博：http://weibo.com/liuhailong2008  
    转载请取得作者同意  

一 基础篇

1、新手接入：
http://mp.weixin.qq.com/wiki/index.php?title=接入指南需要注意的是URL必须是公网能访问的，必须是80端口。
刚才被80端口郁闷了好久，文档中也没明确写。

文档最下面写着：“此外请注意，微信公众号接口只支持80接口”。好吧，是我人品问题。

2、典型案例介绍

http://mp.weixin.qq.com/wiki/index.php?title=典型案例介绍

自定义菜单很酷，如果没有自定义菜单，纯靠写程序响应客户输入，那需要深厚的自然语言处理能力。

需要绑定客户身份，可能是手机号，可能跳转到一个页面绑定。
问题：每次得到的OpenID一样吗？

如果跳转到另一个页面，可以把OpenID隐藏在get中传过去。然后存在隐藏表单域中，你懂的。

3、开发者规范
http://mp.weixin.qq.com/wiki/index.php?title=开发者规范
模板消息和用户数据方面的规范。

“请勿为任何用户自动登录到微信公众平台提供代理身份验证凭据”意思是让每个人用自己的身份凭据。
可以为他人提供身份凭据吗？

“请勿自动将浏览器窗口定向到其他网页”哪个浏览器窗口？

“完整的开发者规范和接口限制，请详见开发者接口文档”
开发者接口文档在哪里？


4、调用接口频率限制
http://mp.weixin.qq.com/wiki/index.php?title=接口频率限制说明

5、调试接口
https://mp.weixin.qq.com/debug/

6、access_token
调用接口时，服务器需要知道调用者身份。
但每次都提交AppID和AppSecret是不是有点傻。服务器也麻烦，每次都要验证。
干脆服务器发良民证，检查AppID和AppSecret没问题就发一个，可以用12分钟。
在这12分钟内，只要检查良民证就可以了。

200 OK
Server: nginx/1.4.4
ConDate: Wed, 07
Content-Type
{
    "access_token": "35r3_cicy-CtwRrK0RoPmt13OIX_WXSxJI1Yd_s5wPghVJ7RU2V8STmH7fcAmD6S",
    "expires_in": 7200
}

7、上传下载多媒体文件
http://mp.weixin.qq.com/wiki/index.php?title=上传下载多媒体文件

200 OK
Content-Length: 118
Date: Wed,
{
    "type": "image",
    "media_id": "DPlBG0Txb3HYzwI4OfJCj9G9ozURJOTVd2W4qAMt5LNMGSc5vy07b2qAHvj_-wJx",
    "created_at": 1399478362
}

请求地址：
http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=35r3_cicy-CtwRrK0RoPmt13OIX_WXSxJI1Yd_s5wPghVJ7RU2V8STmH7fcAmD6S&type=image

"media_id": "Gmr7w0G_4uMxH0PgLF2yQDRjiQSHSFlpWxeuCxIgY9wGf5giBbqemqBX2V9Gddqi"

要自己写Web管理界面？
curl是什么工具？
下载文件，在线调试没通过。报错JSON数据格式不正确。


8、验证消息真实性
http://mp.weixin.qq.com/wiki/index.php?title=验证消息真实性

怎么知道消息是从微信服务器传过来的呢？
和验证成开发者时候一样的。

每次微信服务器请求url都会带signature、timestamp、nonce参数。
url所指向的web程序可以将timestamp、nonce加上token（保存在用户自己服务器上）算出一个字符串，和signature比较。

学习一下微信API的设计，还是不错的。

二、自定义菜单

1、常识
"目前自定义菜单最多包括3个一级菜单，每个一级菜单最多包含5个二级菜单。一级菜单最多4个汉字，二级菜单最多7个汉字，多出来的部分将会以“...”代替。请注意，创建自定

义菜单后，由于微信客户端缓存，需要24小时微信客户端才会展现出来。建议测试时可以尝试取消关注公众账号后再次关注，则可以看到创建后的效果。"

2、菜单相应类型
有click和view两种。定义菜单时，click的同时定义key，view的同时定义url。


3、如何创建菜单

{
  "button":[
     {"type":"click", "name":"关于我","key":"BTN_ABOUT_USER" },
     {"name":"我的伙伴",  "sub_button":[
            {"type":"view","name":"胡磊磊", "url":"http://chaoshi.cgdmc.com/wx/person/hulei.php" },
            {"type":"view","name":"魏超超", "url":"http://chaoshi.cgdmc.com/wx/person/weichao.php"  },
            {"type":"view","name":"雷达达","url":"http://chaoshi.cgdmc.com/wx/person/leida.php"}
 ]
      },
     {"type":"click","name":"关于作者", "key":"BTN_ABOUT_ME"}
   ]
 }

请求地址：
https://api.weixin.qq.com/cgi-bin/menu/create?access_token=xx
返回结果:

200 OK
Content-Length: 27
Date: Wed, 07
Content-Typ
{
    "errcode": 0,
    "errmsg": "ok"
}

4、如何查询现有菜单：（这个有意义吗？自己做一个管理平台？）

200 OK
chaoshi.cgdmc.com: nginx/1.4.4
Con
Date: Wed, 07
Content-Typ
{
    "menu": {
        "button": [
            {
                "type": "click",
                "name": "关于我",
                "key": "BTN_ABOUT_USER",
                "sub_button": [ ]
            },
            {
                "name": "我的伙伴",
                "sub_button": [
                    {
                        "type": "view",
                        "name": "胡磊磊",
                        "url": "http://chaoshi.cgdmc.com/wx/person/hulei.php",
                        "sub_button": [ ]
                    },
                    {
                        "type": "view",
                        "name": "魏超超",
                        "url": "http://chaoshi.cgdmc.com/wx/person/weichao.php",
                        "sub_button": [ ]
                    },
                    {
                        "type": "view",
                        "name": "雷达达",
                        "url": "http://chaoshi.cgdmc.com/wx/person/leida.php",
                        "sub_button": [ ]
                    }
                ]
            },
            {
                "type": "click",
                "name": "关于作者",
                "key": "BTN_ABOUT_ME",
                "sub_button": [ ]
            }
        ]
    }
}

5、自定义菜单删除的话，只能全删
已有的情况下，再次添加，是否就是更新？
试了一下，是的。

6、菜单事件的处理
http://mp.weixin.qq.com/wiki/index.php?title=自定义菜单事件推送
type为view的不需要写代码支持。
只来看type为click的。
需要得到Event和EventKey。
分别点了“关于我”和“关于作者”，自己服务器代码收到的消息是：
gh_xxxxxxxxx（公共平台微信号）
xxxx-0 (用户OpenID)
1399481134
event
CLICK
BTN_ABOUT_USER
和
gh_xxxxxxxxx（公共平台微信号）
xxxx-0 (用户OpenID)
1399481140
event
CLICK
BTN_ABOUT_ME
程序代码里，

if( 'BTN_ABOUT_ME'.equals(eventKey) ){
    response.setMsgType("text");
    response.setContent("我是刘海龙，围脖地址：\nweibo.com/liuhailong2008\n亲，加关注呦！");
}

按照规矩，处理消息前，应该先验证一下。记得不，亲，签名就是干这个用的。

三、 获取用户信息

1、获取用户信息

https://api.weixin.qq.com/cgi-bin/user/info?access_token=tP2ttoAfStr8-1j2QzmNVcuw0wCy_bv5ZPVw2gygKptiwAVm2JN_eo0CpdH1EMeh&openid=oai_Ejvay12_FjT0fWWwc4gSe7-0
返回结果:

200 OK
Server: nginx/1.4.4
Con
Date: Wed, 07
Content-Typ
{
    "subscribe": 1,
    "openid": "oai_xxxe7-0",
    "nickname": "刘海龙",
    "sex": 1,
    "language": "zh_CN",
    "city": "保定",
    "province": "河北",
    "country": "中国",
    "headimgurl": "http://wx.qlogo.cn/mmopen/ezjZug0fpibxah7nkiaYLMgg7RnS0NPHFlt7Yg6BbPTTmq1B1rfI4DCIPofibTcYHnyqMAcr2cyp76A79MCoKicpbQ/0",
    "subscribe_time": 1399480903
}

程序调用返回:

1
oai_EjvxxxWWwc4gSe7-0
刘海龙
1
zh_CN
保定
河北
中国
http://wx.qlogo.cn/mmopen/ezjZug0fpibxah7nkiaYLMgg7RnS0NPHFlt7Yg6BbPTTmq1B1rfI4DCIPofibTcYHnyqMAcr2cyp76A79MCoKicpbQ/0
1399480903
oai_Ejvay12_FjT0fWWwc4gSe7-0
gh_3d3203deb07d
1399482736

完事儿收工！