微信开发模式api接口文档简介

微信公众平台开发模式对于很多人来说还是很难理解,毕竟是代码问题,这份资料,面对的主要也是有编程经验的。对于只会编辑模式的人来说。阅读会有点困难。我们现在就一起来了解一下吧!

1 文本类型息

接口获取到的消息格式:

这类信息是微信公众平台接收到的最多的消息。即用户向微信公众帐号发送文本信息。消息格式为:


文本消息的数据字段:

ToUserName:开发者微信号(公众账号ID)

FromUserName:发送方帐号(微信用户的OPENID,每个微信用户与每个公众账号是唯一的,不同公众账号同个用户OPENID是不同的)

CreateTime:消息创建时间

MsgType:消息类型(文本消息为text)

Content:消息内容

MsgId:消息的ID号

2 图文类型

用户使用图片上传发送消息

接口获取到的消息格式:



图片消息与文本消息数据不同:

MsgType:消息类型为image

PicUrl:图片链接,该图片保存在微信的服务器上,可以通过远程抓取图片程序保存到本地。

3  LBS,用户发送地理位置功能,常用在饮食类等本地的微信公众帐号


接口获取到的消息格式:



地理位置消息与文本消息数据不同:

MsgType:消息类型为location

Location_X、Location_Y、Scale:地理位置的经纬度和地图缩放比例,用于第三方地图接口的应用,搜索周边需要用到

Label:地理位置文字信息,如某某城市某某路某某号,如果以城市为单位查询直接拿这个就可以。

4 链接消息

像微市场的微信公众帐号就采用了很多链接消息的,具体大家可以关注微市场公众帐号体验下哦!



链接消息与文本消息数据不同:

MsgType:消息类型为link

Title:消息标题


Description:消息描述

Url:链接地址

5 语音消息

这个消息接口并不在公开文档上,但事实上有不少微信应用已经在使用,比如路况电台,不全面开放的原因我个人猜测是因为微信自己的语音识别还不理想,未来肯定会开放,想象一下对公众账号说句话后台就能给反馈信息多方便的功能。


接口获取到的消息格式:


语音消息与文本消息数据不同:

MsgType:消息类型为voice

MediaId:语音消息媒体id,可以调用相应接口获取内容

Format:语音类型,如amr,speex,wav等,目前是使用的speex。

6 事件推送

这个接口很重要,目前只开放了用户关注、用户退订,还有自定义菜单按钮相应的功能,部分测试的有用户打开公众号提醒和自动发送地理位置。也就是用户不发送任何内容也可以捕捉用户行为做出回复。

接口获取到的消息格式:


事件推送与文本消息数据不同:

MsgType:消息类型为event

Event:事件内容,subscribe(订阅)、unsubscribe(取消订阅)、CLICK(自定义菜单点击事件)

EventKey:当用户事件为点击自定义菜单时,返回事件KEY值,与自定义菜单接口中KEY值对应。

7 多图文消息类型


与回复文本消息的数据字段的不同:

MsgType:回复消息类型为news

ArticleCount:图文消息个数,限制为10条以内,这个必须准确,有多少条图文消息就得填写多少,不然会出错。

Articles:多条图文消息信息,默认第一个item为大图,每个item的结构完全一样,每个item表示一条图文消息。

Title:图文消息标题

Description:图文消息描述

PicUrl:图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80。

Url:点击图文消息跳转链接,这个链接可以是自己网站链接,但是记得申请白名单,不然出现警告提示用户一般不会点击进去。