消息接口使用指南现在就去申请>>一、简介公众平台消息接口为开发者提供了一种新的消息处理方式二、申请消息接口点击申请,如实填写负责人姓名、号和邮箱,填写网址url和token,其中token可由开发者可以任意填写,用作生成签名三、网址接入公众平台用户提交信息后,我们将以GET请求方式请求到填写的Url上,并且带上四个参数:* signature — 加密签名* timestamp — 时间戳* nonce — 随机数* echostr — 随机字符串开发者通过检验signature对网址接入合法性进行校验若此次GET请求原样返回echostr参数内容,则接入生效,否则接入失败 验证signature将结合开发者填写的token参数、timestamp参数和nonce参数等,加密流程:* 将token、timestamp、nonce三个参数进行字典序排序* 将三个参数字符串拼接成一个字符串进行sha1加密* 开发者获得加密后的字符串可与signature对比,标识该请求来源于四、消息推送当普通用户向公众账号发消息时,公众平台将POST该消息到填写的Url上(现支持文本消息以及地理位置消息)。
结构如下:文本消息xml格式 1348831860 ToUserName 消息接收方号,一般为公众平台账号号 FromUserName 消息发送方号 CreateTime 消息创建时间 MsgType 文本消息为text Content 消息内容 地理位置消息xml格式 1351776360 23.134521 113.358803 20 ToUserName 消息接收方号,一般为公众平台账号号 FromUserName 消息发送方号 CreateTime 消息创建时间 MsgType 消息类型,地理位置为location Location_X 地理位置纬度 Location_Y 地理位置经度 Scale 地图缩放大小 Label 地理位置信息 五、消息回复对于每一个POST请求,开发者在响应包中返回特定xml结构,对该消息进行相应操作(现支持回复文本消息、回复图文消息和星标操作)。
xml结构如下:回复文本消息格式 12345678 0 FromUserName 消息发送方 ToUserName 消息接收方 CreateTime 消息创建时间 MsgType 消息类型,文本消息必须填写text Content 消息内容,大小限制在2048字节,字段为空为不合法请求 回复图文消息格式 12345678 2 -
-
1 FromUserName 消息发送方 ToUserName 消息接收方 CreateTime 消息创建时间 MsgType 消息类型,图文消息必须填写news Content 消息内容,图文消息可填空 ArticleCount 图文消息个数,限制为10条以内 Articles 多条图文消息信息,默认第一个item为大图 Title 图文消息标题 Discription 图文消息描述 PicUrl 图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80,限制图片链接的域 名需要与开发者填写的基本资料中的Url一致 Url 点击图文消息跳转链接 星标消息在xml结构中,有一个FuncFlag字段,开发者可以通过填写FuncFlag字段为1来对消息进行星标,你可以在实时消息的星标消息分类中找到该消息。