本文分为三大部分为大家进行介绍,具体内容如下
1、微信用户、微信服务器和后台服务器的交互
例:微信用户向公众号发送一条文本消息,这条消息会首先传给微信服务器,微信服务器处理这条信息并将其以xml数据格式传递给后台服务器,后台服务器接受到数据后会对数据进行处理,再响应数据以xml数据格式传递给微信服务器,微信服务器再响应到用户微信界面。 微信用户与微信后台服务器之间的交互过程就是数据传递过程,只不过需要需要通过微信服务器这个中转站。
那么微信服务器这个中转站到底有什么用? 对xml数据进行加工包装后展现在手机屏幕上。我们接受的图文消息,如下:
单图文:
多图文
你会发现微信上几乎所有的图文都是这种格式,板式、大小都是一样,这就是经过微信服务器包装后的结果。
2、交互的数据类型
微信用户可以发送的数据类型 1、文本型(text)
2、语音(voice)
3、图片( img)
每一条消息传给微信服务器后都会被标记一个MsgId,上传的图片、视频、语音等也会被标记一个mediaId。
4、视频(video)
5、地理位置消息(location)
6、链接消息(link)
后台服务器响应的消息类型 1、文本型(text) 2、语音(voice)
3、图片( img)
4、视频(video)
5、音乐(music)
6、图文(news)
上面代码在数据填写方面只做参照。以上代码在需要的时候调用即可,这里只是为大家展现以下数据格式。 CDATA是一个标记,被其标记的文本数据中不会被xml解析器进行解析。一个 CDATA 部件以"
ToUserName 接收方帐号 FromUserName 发送方帐号 CreateTime 发送事件 MsgType 数据类型 Content 文本内容 ArticleCount 图文数量 MsgId 数据id MediaId 媒介id Title 标题 Description 描述 MusicUrl 音乐连接地址 HQMusicUrl 高品质音乐连接地址
2、具体的交互步骤即代码
在上一章图2中,我们为测试号定义了url和token。url就是与微信服务器进行通信的后台服务器地址,而token一个相当于一个令牌。微信服务器与后台服务器进行通信时会出示该令牌,如果后台服务器发现微信服务器与自己携带的令牌相同才会进行通信,不相同则拒绝通信 。这个过程叫做token验证(这个令牌不是token的值)。
上面比较形象的说话,下面我通过代码来解释
例如:url为
class wechatCallbackapiTest private function checkSignature() if($tmpStr == $signature){ public function responseMsg() //用户发送的消息类型判断 private function receiveText($object) if($keyword == "文本"){ } return $result; private function receiveImage($object) private function receiveVoice($object) private function receiveVideo($object) /* /* $item_str = sprintf($itemTpl,$imageArray['MediaId']); $textTpl = " $result = sprintf($textTpl,time()); /* $item_str = sprintf($itemTpl,$voiceArray['MediaId']); $textTpl = " $result = sprintf($textTpl,time()); /* $item_str = sprintf($itemTpl,$videoArray['MediaId'],$videoArray['ThumbMediaId'],$videoArray['Title'],$videoArray['Description']); $textTpl = " $result = sprintf($textTpl,time()); /* $itemTpl = " $newsTpl = " $result = sprintf($newsTpl,count($arr_item)); /* $item_str = sprintf($itemTpl,$musicArray['Title'],$musicArray['Description'],$musicArray['MusicUrl'],$musicArray['HQMusicUrl']); $textTpl = " $result = sprintf($textTpl,time());
{
public function valid()
{
$echoStr = $_GET["echostr"];
if($this->checkSignature()){
echo $echoStr;
exit;
}
}
{
$signature = $_GET["signature"];
$timestamp = $_GET["timestamp"];
$nonce = $_GET["nonce"];
$token = TOKEN;
$tmpArr = array($token,$timestamp,$nonce);
sort($tmpArr);//对数组中的元素进行排序
$tmpStr = implode($tmpArr);//将数组中的元素连接成一个字符串
$tmpStr = sha1($tmpStr);//对字符串进行加密操作。
return true;
}else{
return false;
}
}
{
$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];//获取发送过来的数据。
if (!empty($postStr)){
$postObj = simplexml_load_string($postStr,'SimpleXMLElement',);//把xml字符串载入到一个SimpleXMLelement对象中。simplexml_load_string()是一种xml解析器。
$RX_TYPE = trim($postObj->MsgType);//trim去掉字符串两端kongge。
switch ($RX_TYPE)
{
case "text":
$result = $this->receiveText($postObj);
break;
case "image":
$result = $this->receiveImage($postObj);
break;
case "voice":
$result = $this->receiveVoice($postObj);
break;
case "video":
$result = $this->receiveVideo($postObj);
break;
default:
$result = "unknow msg type: ".$RX_TYPE;
break;
}
echo $result;
}else {
echo "";
exit;
}
}
{
$keyword = trim($object->Content);
//回复文本消息
$content = "这是个文本消息";
$result = $this->transmitText($object,$content);
}
else if($keyword == "图文" || $keyword == "单图文"){
//回复单图文消息
$content = array();
$content[] = array("Title"=>"单图文标题","Description"=>"单图文内容","PicUrl"=>"http://discuz.comli.com/weixin/weather/icon/cartoon.jpg","Url" =>"http://m.cnblogs.com/?u=txw1958");
$result = $this->transmitNews($object,$content);
}
else if($keyword == "多图文"){
//回复多图文消息
$content = array();
$content[] = array("Title"=>"多图文1标题","Description"=>"","Url" =>"http://m.cnblogs.com/?u=txw1958");
$content[] = array("Title"=>"多图文2标题","PicUrl"=>"http://d.hiphotos.bdimg.com/wisegame/pic/item/f3529822720e0cf3ac9f1ada0846f21fbe09aaa3.jpg","Url" =>"http://m.cnblogs.com/?u=txw1958");
$content[] = array("Title"=>"多图文3标题","PicUrl"=>"http://g.hiphotos.bdimg.com/wisegame/pic/item/18cb0a46f21fbe090d338acc6a600c338644adfd.jpg",$content);
else if($keyword == "音乐"){
//回复音乐消息
$content = array("Title"=>"最炫民族风","Description"=>"歌手:凤凰传奇","MusicUrl"=>"http://121.199.4.61/music/zxmzf.mp3","HQMusicUrl"=>"http://121.199.4.61/music/zxmzf.mp3");
$result = $this->transmitMusic($object,$content);
}
}
{
//回复图片消息
$content = array("MediaId"=>$object->MediaId);
$result = $this->transmitImage($object,$content);;
return $result;
}
{
//回复语音消息
$content = array("MediaId"=>$object->MediaId);
$result = $this->transmitVoice($object,$content);;
return $result;
}
{
//回复视频消息
$content = array("MediaId"=>$object->MediaId,"ThumbMediaId"=>$object->ThumbMediaId,"Title"=>"","Description"=>"");
$result = $this->transmitVideo($object,$content);;
return $result;
}
*/
private function transmitText($object,$content)
{
$textTpl = "
*/
private function transmitImage($object,$imageArray)
{
$itemTpl = "
return $result;
}
*/
private function transmitVoice($object,$voiceArray)
{
$itemTpl = "
return $result;
}
*/
private function transmitVideo($object,$videoArray)
{
$itemTpl = "";
return $result;
}
*/
private function transmitNews($object,$arr_item)
{
if(!is_array($arr_item))
return;
return $result;
}
*/
private function transmitMusic($object,$musicArray)
{
$itemTpl = "
return $result;
}
}
?>3.接口
3.1 接口是什么
接口就相当于一个工具,具备特定的功能。比如你在建造房子的时候需要在墙上钻孔,你就会使用钻机工具来钻孔。从调来工具到钻孔完成,你要完成插电、校准、钻孔等一系列步骤,最终实现你的目标。钻机就是我们的接口,插电、校准、钻孔就是我们调用工具完成目的步骤。
微信的创建菜单接口举例。
调用接口的步骤: 1、获得微信菜单接口的连接地址,通过curl函数与这个接口建立对话。 2、把创建菜单数据发送给这个接口。 接口调用完成,这个接口会自动把这些数据进行处理并在微信公众好页面生成菜单。
微信接口的调用方式请看下一章:微信公众平台开发(三):。