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


先上效果图:

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



    作者博客: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

完事儿收工!

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

上一篇:微信公众号发送消息


下一篇:Guava 是个风火轮之函数式编程(1)