WeChatパブリックプラットフォームの開発とメッセージ受信の基本原則

1. 基本原則

始める前は、これにとても興味があるかもしれませんが、迷ってしまいます。複雑ですか？学ぶのは難しいですか？

実際はその逆で、とてもシンプルです。皆さんの懸念を払拭するために、まず WeChat パブリック プラットフォームの基本原則を簡単に紹介します。

WeChat サーバーは転送サーバーに相当します。端末 (携帯電話、Pad など) は WeChat サーバーへのリクエストを開始し、WeChat サーバーはそのリクエストをカスタム サービスに転送します (これは私たちの特定の実装です)。 。

サービスが処理された後、それは WeChat サーバーに蒸発され、WeChat サーバーは特定の応答を端末に返します。

通信プロトコルは: HTTP

データ形式は: XML

具体的なプロセスは次の図に示すとおりです:

実際に行う必要があるのは、HTTP リクエストに応答することです。

特定の XML 形式に従って特定のリクエストのコンテンツを解析し、処理した後、それを特定の XML 形式に従って返す必要があります。

必要なのは HttpHandler の簡単な実装だけです。

もちろん、WeChat プラットフォームはより複雑なビジネスを実装することもできます。たとえば、WeChat リンクを介して htm インターフェイスを開き、独自のロジックを実装することもできます。

2. メッセージインターフェース (公式ドキュメント)

メッセージインターフェースを申請します

[適用] をクリックし、URL とトークンを入力します。トークンは開発者が任意に入力し、トークンを生成するために使用できます。サイン。

ウェブサイトへのアクセス

パブリックプラットフォームユーザーが情報を送信すると、WeChatサーバーは、次の4つのパラメータを指定して、入力されたURLにGETリクエストを送信します:

Parameters	Description
signature	WeChat暗号化署名
タイムスタンプ	タイムスタンプ
nonce	乱数
echostr	ランダム文字列

リクエストを検証して署名をチェックします 検証を実行します (下記) 検証方法）。この GET リクエストが WeChat サーバーからのものであることが確認された場合は、echostr パラメータの内容をそのまま返すとアクセスが有効になります。それ以外の場合はアクセスが失敗します。

signature は、開発者によって入力されたトークンパラメータと、リクエスト内のタイムスタンプパラメータおよびノンスパラメータを組み合わせます。

加密/校验流程：
1. 将token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行sha1加密
3. 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信

メッセージプッシュ

一般の WeChat ユーザーが公開アカウントにメッセージを送信すると、WeChat サーバーは入力された URL にメッセージを POST します。構造は次のとおりです:

テキストメッセージ

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName> 
 <CreateTime>1348831860</CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content><![CDATA[this is a test]]></Content>
 <MsgId>1234567890123456</MsgId>
 </xml>

パラメータ	説明
ToUserName	開発者WeChat ID
FromUserName	送信者アカウント (OpenID)
CreateTime	メッセージ作成時刻 (整数)
MsgType	text
Content	テキストメッセージの内容
MsgId	メッセージID、64ビット整数

ピクチャーメッセージ

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>1348831860</CreateTime>
 <MsgType><![CDATA[image]]></MsgType>
 <PicUrl><![CDATA[this is a url]]></PicUrl>
 <MsgId>1234567890123456</MsgId>
 </xml>

パラメータ	説明
ToUserName	開発者WeChat ID
FromUserName	送信者アカウント(OpenID)
CreateTime	メッセージ作成時間 (タイプ全体)
MsgType	image
PicUrl	画像リンク
MsgId	メッセージID、64ビット整数型

地理位置情報メッセージ

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[location]]></MsgType>
<Location_X>23.134521</Location_X>
<Location_Y>113.358803</Location_Y>
<Scale>20</Scale>
<Label><![CDATA[位置信息]]></Label>
<MsgId>1234567890123456</MsgId>
</xml>

地理位置情報MsgIdメッセージID、64ビット整数型

链接消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[link]]></MsgType>
<Title><![CDATA[公众平台官网链接]]></Title>
<Description><![CDATA[公众平台官网链接]]></Description>
<Url><![CDATA[url]]></Url>
<MsgId>1234567890123456</MsgId>
</xml>

パラメータ	説明
ToUserName	DeveloperWeChat ID
FromUserName	送信者アカウント(OpenID)
CreateTime	メッセージ作成時刻(整数)
メッセージタイプ	場所
Location_

参数	描述
ToUserName	接收方微信号
FromUserName	发送方微信号，若为普通用户，则是一个OpenID
CreateTime	消息创建时间
MsgType	消息类型，link
Title	消息标题
Description	消息描述
Url	消息链接
MsgId	消息id，64位整型

事件推送

事件推送只支持微信4.5版本，目前开启自定义菜单接口事件推送、关注与取消关注事件推送。其余功能即将开放，敬请期待。

<xml><ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[EVENT]]></Event>
<EventKey><![CDATA[EVENTKEY]]></EventKey>
</xml>

参数	描述
ToUserName	接收方微信号
FromUserName	发送方微信号，若为普通用户，则是一个OpenID
CreateTime	消息创建时间
MsgType	消息类型，event
Event	事件类型，subscribe(订阅)、unsubscribe(取消订阅)、CLICK(自定义菜单点击事件)
EventKey	事件KEY值，与自定义菜单接口中KEY值对应

消息回复

对于每一个POST请求，开发者在响应包中返回特定xml结构，对该消息进行响应（现支持回复文本、图文、语音、视频、音乐）。

微信服务器在五秒内收不到响应会断掉连接。

回复xml结构如下：

回复文本消息

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content><![CDATA[content]]></Content>
 </xml>

参数	描述
ToUserName	接收方帐号（收到的OpenID）
FromUserName	开发者微信号
CreateTime	消息创建时间
MsgType	text
Content	回复的消息内容,长度不超过2048字节

回复音乐消息

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[music]]></MsgType>
 <Music>
 <Title><![CDATA[TITLE]]></Title>
 <Description><![CDATA[DESCRIPTION]]></Description>
 <MusicUrl><![CDATA[MUSIC_Url]]></MusicUrl>
 <HQMusicUrl><![CDATA[HQ_MUSIC_Url]]></HQMusicUrl>
 </Music>
 </xml>

参数	描述
ToUserName	接收方帐号（收到的OpenID）
FromUserName	开发者微信号
CreateTime	消息创建时间
MsgType	music
MusicUrl	音乐链接
HQMusicUrl	高质量音乐链接，WIFI环境优先使用该链接播放音乐

回复图文消息

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[news]]></MsgType>
 <ArticleCount>2</ArticleCount>
 <Articles>
 <item>
 <Title><![CDATA[title1]]></Title> 
 <Description><![CDATA[description1]]></Description>
 <PicUrl><![CDATA[picurl]]></PicUrl>
 <Url><![CDATA[url]]></Url>
 </item>
 <item>
 <Title><![CDATA[title]]></Title>
 <Description><![CDATA[description]]></Description>
 <PicUrl><![CDATA[picurl]]></PicUrl>
 <Url><![CDATA[url]]></Url>
 </item>
 </Articles>
 </xml>

参数	描述
ToUserName	接收方帐号（收到的OpenID）
FromUserName	开发者微信号
CreateTime	消息创建时间
MsgType	news
ArticleCount	图文消息个数，限制为10条以内
Articles	多条图文消息信息，默认第一个item为大图
Title	图文消息标题
Description	图文消息描述
PicUrl	图片链接，支持JPG、PNG格式，较好的效果为大图640*320，小图80*80。
Url	点击图文消息跳转链接

官方接口文档：

http://mp.weixin.qq.com/wiki/index.php?title=%E6%B6%88%E6%81%AF%E6%8E%A5%E5%8F%A3%E6%8C%87%E5%8D%97

注意事项

1.用户OpenID对一个公众号是固定唯一的串

2.请使用80端口

尽请关注：后续我们将全面讲解具体的开发过程。

三、消息类图

 

更多WeChatパブリックプラットフォームの開発とメッセージ受信の基本原則相关文章请关注PHP中文网！