微信公众平台消息接口API指南9P.docx
- 文档编号:10545670
- 上传时间:2023-02-21
- 格式:DOCX
- 页数:10
- 大小:37.20KB
微信公众平台消息接口API指南9P.docx
《微信公众平台消息接口API指南9P.docx》由会员分享,可在线阅读,更多相关《微信公众平台消息接口API指南9P.docx(10页珍藏版)》请在冰豆网上搜索。
微信公众平台消息接口API指南9P
简介
微信公众平台消息接口为开发者提供了一种新的消息处理方式。
微信公众平台消息接口为开发者提供与用户进行消息交互的能力。
对于成功接入消息接口的微信公众账号,当用户发消息给公众号,微信公众平台服务器会使用http请求对接入的网址进行消息推送,第三方服务器可通过响应包回复特定结构,从而达到回复消息的目的。
申请消息接口
点击申请,填写网址url和token,其中token可由开发者可以任意填写,用作生成签名。
网址接入
公众平台用户提交信息后,微信服务器将发送GET请求到填写的URL上,并且带上四个参数:
参数
描述
signature
微信加密签名
timestamp
时间戳
nonce
随机数
echostr
随机字符串
开发者通过检验signature对请求进行校验(下面有校验方式)。
若确认此次GET请求来自微信服务器,请原样返回echostr参数内容,则接入生效,否则接入失败。
signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。
加密/校验流程:
1.将token、timestamp、nonce三个参数进行字典序排序
2.将三个参数字符串拼接成一个字符串进行sha1加密
3.开发者获得加密后的字符串可与signature对比,标识该请求来源于微信
消息推送
当普通微信用户向公众账号发消息时,微信服务器将POST该消息到填写的URL上。
结构如下:
文本消息
[CDATA[toUser]]>
[CDATA[fromUser]]>
[CDATA[text]]>
[CDATA[thisisatest]]>
参数
描述
ToUserName
开发者微信号
FromUserName
发送方帐号(一个OpenID)
CreateTime
消息创建时间(整型)
MsgType
text
Content
文本消息内容
MsgId
消息id,64位整型
图片消息
[CDATA[toUser]]>
[CDATA[fromUser]]>
[CDATA[image]]>
[CDATA[thisisaurl]>
参数
描述
ToUserName
开发者微信号
FromUserName
发送方帐号(一个OpenID)
CreateTime
消息创建时间(整型)
MsgType
image
PicUrl
图片链接
MsgId
消息id,64位整型
地理位置消息
[CDATA[toUser]]>
[CDATA[fromUser]]>
[CDATA[location]]>
参数
描述
ToUserName
开发者微信号
FromUserName
发送方帐号(一个OpenID)
CreateTime
消息创建时间(整型)
MsgType
location
Location_X
地理位置维度
Location_Y
地理位置经度
Scale
地图缩放大小
Label
地理位置信息
MsgId
消息id,64位整型
链接消息
[CDATA[toUser]]>
[CDATA[fromUser]]>
[CDATA[link]]>
[CDATA[公众平台官网链接]]>
[CDATA[公众平台官网链接]]>
[CDATA[url]]>
参数
描述
ToUserName
接收方微信号
FromUserName
发送方微信号,若为普通用户,则是一个OpenID
CreateTime
消息创建时间
MsgType
消息类型,link
Title
消息标题
Description
消息描述
Url
消息链接
MsgId
消息id,64位整型
事件推送
事件推送只支持微信4.5版本,即将开放,敬请期待。
[CDATA[toUser]]>
[CDATA[fromUser]]>
[CDATA[event]]>
[CDATA[LOCATION]]>
参数
描述
ToUserName
接收方微信号
FromUserName
发送方微信号,若为普通用户,则是一个OpenID
CreateTime
消息创建时间
MsgType
消息类型,event
Event
事件类型,有ENTER(进入会话)和LOCATION(地理位置)
Latitude
地理位置维度,事件类型为LOCATION的时存在
Longitude
地理位置经度,事件类型为LOCATION的时存在
Precision
地理位置精度,事件类型为LOCATION的时存在
消息回复
对于每一个POST请求,开发者在响应包中返回特定xml结构,对该消息进行响应(现支持回复文本、图文、语音、视频、音乐和对收到的消息进行星标操作)。
微信服务器在五秒内收不到响应会断掉连接。
回复xml结构如下:
回复文本消息
[CDATA[toUser]]>
[CDATA[fromUser]]>
[CDATA[text]]>
[CDATA[content]]>
参数
描述
ToUserName
接收方帐号(收到的OpenID)
FromUserName
开发者微信号
CreateTime
消息创建时间
MsgType
text
Content
回复的消息内容
FuncFlag
位0x0001被标志时,星标刚收到的消息。
回复音乐消息
[CDATA[toUser]]>
[CDATA[fromUser]]>
[CDATA[music]]>
[CDATA[TITLE]]>
[CDATA[DESCRIPTION]]>
[CDATA[MUSIC_Url]]>
[CDATA[HQ_MUSIC_Url]]>
参数
描述
ToUserName
接收方帐号(收到的OpenID)
FromUserName
开发者微信号
CreateTime
消息创建时间
MsgType
music
MusicUrl
音乐链接
HQMusicUrl
高质量音乐链接,WIFI环境优先使用该链接播放音乐
FuncFlag
位0x0001被标志时,星标刚收到的消息。
回复图文消息
[CDATA[toUser]]>
[CDATA[fromUser]]>
[CDATA[news]]>
[CDATA[title1]]>
[CDATA[description1]]>
[CDATA[picurl]]>
[CDATA[url]]>
[CDATA[title]]>
[CDATA[description]]>
[CDATA[picurl]]>
[CDATA[url]]>
参数
描述
ToUserName
接收方帐号(收到的OpenID)
FromUserName
开发者微信号
CreateTime
消息创建时间
MsgType
news
ArticleCount
图文消息个数,限制为10条以内
Articles
多条图文消息信息,默认第一个item为大图
Title
图文消息标题
Description
图文消息描述
PicUrl
图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80,限制图片链接的域名需要与开发者填写的基本资料中的Url一致
Url
点击图文消息跳转链接
注意事项
1.用户OpenID对一个公众号是固定唯一的串
2.请使用80端口
3.用户关注公众号,微信公众平台服务器推送一条内容为Hello2BizUser的文本消息到第三方服务器
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 公众 平台 消息 接口 API 指南