微信公众号开发（二）基础接口

最新推荐文章于 2024-05-17 00:44:01 发布
最新推荐文章于 2024-05-17 00:44:01 发布
阅读量8.5k 收藏 21
点赞数 7
分类专栏： 微信公众号开发 文章标签： 微信 公众号 基础接口 订阅号 服务号
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_28506819/article/details/77842089
版权

微信公众号开发（二）基础接口

 

未经认证的订阅号只有基础接口的权限，基础接口主要包括三个部分：接收用户消息、发送被动响应消息和接收事件推送消息，开发者需要对用户消息在5秒内立即做出回应，微信服务器在五秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次。假如服务器无法保证在五秒内处理并回复，可以直接回复空串，微信服务器不会对此作任何处理，并且不会发起重试。

 

微信公众号能够接收用户发送的6种格式的消息：文本（包括表情）、图片、语音、视频、地理位置、链接。具体格式参见普通消息格式

微信公众号能够回复用户发送的6种类型消息：文本、图片、语音、视频、音乐、图文（单图文和多图文）。具体格式参见被动回复消息格式

基础接口中事件消息只有：关注和取消关注事件。

 

文件结构如下：

 

images文件夹用来存放图文消息用到的图片，music文件夹用来存放音乐文件；关于output_log.php、output_query.php和Utils.php这三个文件，请参看微信公众号开发（一）服务器及接口的配置，其主要功能是日志的打印；test.php是点击图文跳转到的链接；index.php用来处理消息。

 

test.php，这里只输出一个字符串。

<?php
echo "haha";

 

下面我们直接上index.php的代码，之后将会给出实际效果的截图以及发送数据的结构。

<?php
//设置时区
date_default_timezone_set("Asia/Shanghai");
//定义TOKEN常量，这里的"weixin"就是在公众号里配置的TOKEN
define("TOKEN", "weixin");

require_once("Utils.php");
//打印请求的URL查询字符串到query.xml
Utils::traceHttp();

$wechatObj = new wechatCallBackapiTest();
/**
 * 如果有"echostr"字段，说明是一个URL验证请求，
 * 否则是微信用户发过来的信息
 */
if (isset($_GET["echostr"])){
    $wechatObj->valid();
}else {
    $wechatObj->responseMsg();
}

class wechatCallBackapiTest
{
    /**
     * 用于微信公众号里填写的URL的验证，
     * 如果合格则直接将"echostr"字段原样返回
     */
    public function valid()
    {
        $echoStr = $_GET["echostr"];
        if ($this->checkSignature()){
            echo $echoStr;
            exit;
        }
    }

    /**
     * 用于验证是否是微信服务器发来的消息
     * @return bool
     */
    private function checkSignature()
    {
        $signature = $_GET["signature"];
        $timestamp = $_GET["timestamp"];
        $nonce = $_GET["nonce"];

        $token = TOKEN;
        $tmpArr = array($token, $timestamp, $nonce);
        sort($tmpArr);
        $tmpStr = implode($tmpArr);
        $tmpStr = sha1($tmpStr);

        if ($tmpStr == $signature){
            return true;
        }else {
            return false;
        }
    }

    /**
     * 响应用户发来的消息
     */
    public function responseMsg()
    {
        //获取post过来的数据，它一个XML格式的数据
        $postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
        //将数据打印到log.xml
        Utils::logger($postStr);
        if (!empty($postStr)){
            //将XML数据解析为一个对象
            $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
            $RX_TYPE = trim($postObj->MsgType);
            //消息类型分离
            switch($RX_TYPE){
                case "event": //事件
                    $result = $this->receiveEvent($postObj);
                    break;
                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;
                case "location": //地理位置
                    $result = $this->receiveLocation($postObj);
                    break;
                case "link": //链接
                    $result = $this->receiveLink($postObj);
                    break;
                default:
                    $result = "unknow msg type:".$RX_TYPE;
                    break;
            }
            //打印输出的数据到log.xml
            Utils::logger($result, '公众号');
            echo $result;
        }else{
            echo "";
            exit;
        }
    }

    /**
     * 接收文本消息,通过发送指定文本，
     * 让服务器回复相应类型的信息
     */
    private function receiveText($object)
    {
        $keyword = trim($object->Content);
        if (strstr($keyword, "文本")){
            $content = "这是个文本消息";
            //回复文本
            $result = $this->transmitText($object, $content);
        }else if (strstr($keyword, "单图文")){
            $content = array();
            $content[] = array("Title"=>"单图文标题", "Description"=>"单图文内容",
                               "PicUrl"=>"http://weiweiyi.duapp.com/images/img1.jpg", "Url"=>"http://weiweiyi.duapp.com/test.php");
            //回复单图文
            $result = $this->transmitNews($object, $content);
        }else if (strstr($keyword, "多图文")){
            $content = array();
            $content[] = array("Title"=>"多图文1标题", "Description"=>"多图文1描述",
                               "PicUrl"=>"http://weiweiyi.duapp.com/images/img1.jpg", "Url"=>"http://weiweiyi.duapp.com/test.php");
            $content[] = array("Title"=>"多图文2标题", "Description"=>"多图文2描述",
                               "PicUrl"=>"http://weiweiyi.duapp.com/images/img2.jpg", "Url"=>"http://weiweiyi.duapp.com/test.php");
            $content[] = array("Title"=>"多图文3标题", "Description"=>"多图文3描述",
                               "PicUrl"=>"http://weiweiyi.duapp.com/images/img3.jpg", "Url"=>"http://weiweiyi.duapp.com/test.php");
            //回复多图文
            $result = $this->transmitNews($object, $content);
        }else if (strstr($keyword, "音乐")){
            $content = array("Title"=>"好想你", "Description"=>"歌手：朱主爱",
                             "MusicUrl"=>"http://weiweiyi.duapp.com/music/missyou.mp3",
                             "HQMusicUrl"=>"http://weiweiyi.duapp.com/music/missyou.mp3");
            //回复音乐
            $result = $this->transmitMusic($object, $content);
        }else {
            $content = date("Y-m-d", time())."\n".$object->FromUserName."\n-lzc";
            //回复文本
            $result = $this->transmitText($object, $content);
        }
        return $result;
    }

    /**
     * 接收图片消息，通过MediaId回复相同的图片给用户
     */
    private function receiveImage($object)
    {
        $content = array("MediaId"=>$object->MediaId);
        $result = $this->transmitImage($object, $content);
        return $result;
    }

    /*
     * 接收语音消息，通过MediaId回复相同的语音给用户
     */
    private function receiveVoice($object)
    {
        $content = array("MediaId"=>$object->MediaId);
        $result = $this->transmitVoice($object, $content);
        return $result;
    }

    /**
     * 接收视频消息，通过MediaId回复相同的视频给用户，
     * 这个会失败，好像是腾讯的视频需要经过审核才能发送，
     * 避免那种***的视频传播
     */
    private function    receiveVideo($object)
    {
        $content = array("MediaId"=>$object->MediaId, "ThumbMediaId"=>$object->ThumbMediaId,
                         "Title"=>"自拍视频", "Description"=>"一个自拍视频");
        $result = $this->transmitVideo($object, $content);
        return $result;
    }

    /**
     * 接收位置消息
     */
    private function receiveLocation($object)
    {
        $content = "你发送的是位置，纬度为：".$object->Location_X."；经度为：".
            $object->Location_Y."；缩放级别为：".$object->Scale."；位置为：".$object->Label;
        $result = $this->transmitText($object, $content);
        return $result;
    }

    /**
     * 接收链接消息
     */
    private function receiveLink($object)
    {
        $content = "你发送的是链接，标题为：".$object->Title."；内容为：".
            $object->Description."；链接地址为：".$object->Url;
        $result = $this->transmitText($object, $content);
        return $result;
    }

    /**
     * 接收事件消息
     */
    private function receiveEvent($object)
    {
        switch ($object->Event){
            case "subscribe":  //关注公众号事件
                $content = "欢迎关注微微一笑很倾城";
                break;
            case "unsubscribe":  //取消关注事件，取消后用户就收不到消息了，
                $content = "";   //所以发送 ""
                break;
            default:
                $content = "";
                break;
        }
        $result = $this->transmitText($object, $content);
        return $result;
    }

    /**
     * 回复文本消息
     */
    private function transmitText($object, $content)
    {
        $xmlTpl = "<xml>
    <ToUserName><![CDATA[%s]]></ToUserName>
    <FromUserName><![CDATA[%s]]></FromUserName>
    <CreateTime><![CDATA[%s]]></CreateTime>
    <MsgType><![CDATA[text]]></MsgType>
    <Content><![CDATA[%s]]></Content>
</xml>";
        $result = sprintf($xmlTpl, $object->FromUserName, $object->ToUserName, time(), $content);
        return $result;
    }

    /**
     * 回复图文消息
     */
    private function transmitNews($object, $newsArray)
    {
        if (!is_array($newsArray)){
            return;
        }
        $itemTpl = "<item>
    <Title><![CDATA[%s]]></Title>
    <Description><![CDATA[%s]]></Description>
    <PicUrl><![CDATA[%s]]></PicUrl>
    <Url><![CDATA[%s]]></Url>
</item>";
        $item_str = "";
        foreach ($newsArray as $item){
            $item_str .= sprintf($itemTpl, $item["Title"], $item["Description"],
                $item["PicUrl"], $item["Url"]);
        }
        $xmlTpl = "<xml>
    <ToUserName><![CDATA[%s]]></ToUserName>
    <FromUserName><![CDATA[%s]]></FromUserName>
    <CreateTime><![CDATA[%s]]></CreateTime>
    <MsgType><![CDATA[news]]></MsgType>
    <ArticleCount>%s</ArticleCount>
    <Articles>$item_str</Articles>
</xml>";
        $result = sprintf($xmlTpl, $object->FromUserName, $object->ToUserName, time(),
            count($newsArray));
        return $result;
    }

    /**
     * 回复音乐消息
     */
    private function transmitMusic($object, $musicArray)
    {
        $itemTpl = "<Music>
    <Title><![CDATA[%s]]></Title>
    <Description><![CDATA[%s]]></Description>
    <MusicUrl><![CDATA[%s]]></MusicUrl>
    <HQMusicUrl><![CDATA[%s]]></HQMusicUrl>
</Music>";
        $item_str = sprintf($itemTpl, $musicArray["Title"], $musicArray["Description"],
            $musicArray["MusicUrl"], $musicArray["HQMusicUrl"]);
        $xmlTpl = "<xml>
    <ToUserName><![CDATA[%s]]></ToUserName>
    <FromUserName><![CDATA[%s]]></FromUserName>
    <CreateTime>%s</CreateTime>
    <MsgType><![CDATA[music]]></MsgType>
    $item_str;
</xml>";
        $result = sprintf($xmlTpl, $object->FromUserName, $object->ToUserName, time());
        return $result;
    }

    /**
     * 回复图片消息
     */
    private function transmitImage($object, $imageArray)
    {
        $itemTpl = "<Image>
    <MediaId><![CDATA[%s]]></MediaId>
</Image>";

        $item_str = sprintf($itemTpl, $imageArray['MediaId']);

        $textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
$item_str
</xml>";
        $result = sprintf($textTpl, $object->FromUserName, $object->ToUserName,
            time());
        return $result;
    }

    /**
     * 回复语音消息
     */
    private function transmitVoice($object, $voiceArray)
    {
        $itemTpl = "<Voice>
    <MediaId><![CDATA[%s]]></MediaId>
</Voice>";

        $item_str = sprintf($itemTpl, $voiceArray['MediaId']);

        $textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
$item_str
</xml>";

        $result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time());
        return $result;
    }

    /**
     * 回复视频消息
     */
    private function transmitVideo($object, $videoArray)
    {
        $itemTpl = "<Video>
    <MediaId><![CDATA[%s]]></MediaId>
    <ThumbMediaId><![CDATA[%s]]></ThumbMediaId>
    <Title><![CDATA[%s]]></Title>
    <Description><![CDATA[%s]]></Description>
</Video>";

        $item_str = sprintf($itemTpl, $videoArray['MediaId'], $videoArray['ThumbMediaId'],
            $videoArray['Title'], $videoArray['Description']);

        $textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
$item_str
</xml>";

        $result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time());
        return $result;
    }
}


发送“文本”，服务器回复文本消息

 

发送图片，服务器这根据MediaId回复相同的图片

发送语音，服务器这根据MediaId回复相同的语音，其中Recognition字段是语音识别结果，需要开通语音识别功能才会有该字段，可在测试号中开通。

发送视频，根据MediaId返回相同视频，可以看到，虽然数据正确返回了，但视频并没有显示出来，推测是视频需要审核才能够发布。

发送地理位置，回复经纬度和地区给用户

 

发送链接。链接的发送方式是收藏别的公众号的图文消息，然后在该公众号中从收藏中发送链接。

 

接收音乐消息

 

接收单图文消息

 

接收多图文

 

 

 

 

好了，这就是微信公众号的基础接口的全部消息了，很简单，只要熟悉了相应数据的XML格式就可以 了。

下一章我们将学习微信公众号的高级接口。

相关博客

微信公众号开发（一）服务器及接口的配置

微信公众号开发（二）基础接口

微信公众号开发（三）获取access_token

微信公众号开发（四）自定义菜单

微信公众号开发（五）个性化菜单

微信公众号开发（六）素材管理

微信公众号开发（七）发送客服消息

微信公众号开发（八）用户管理

微信公众号开发（九）群发消息接口

微信公众号开发（十）模板消息

微信公众号开发（十一）生成带参数二维码

微信公众号开发（十二）OAuth2.0网页授权

zc的救赎
关注
  • 7
    点赞
  • 踩
  • 21
    收藏
    觉得还不错? 一键收藏
  • 3
    评论
专栏目录
微信公众号开发教程(一) 验证接入
wolfcode_cn的博客
06-22 7万+
作者：陈惠，叩丁狼教育高级讲师。原创文章，转载请注明出处。微信公众号开发教程(一)验证接入本篇文章主要介绍了微信公众号开发接入详细流程，希望对刚接触公众号开发的同学有所帮助，有兴趣的同学可多多关注叩丁狼公众号，后续会更新不同的公众号小案例。公众号的分类我们平常在微信应用上会看到有很多的公众号，但是各自并不一样，公众号也分很多种类型，不过最常见的就是服务号和订阅号了。下面我们来看一下他们的区别：1、...
PHP对接微信公众平台消息接口开发流程详解及实例（一）
w384694051的博客
08-09 8559
这篇文章主要介绍了PHP对接微信公众平台消息接口开发流程,如何使用PHP版接口操作公众平台消息,需要的朋友可以参考下 一、写好接口程序 在你的服务器上上传好一个接口程序文件内容如下： 代码如下: define("TOKEN", "weixin");//自己定义的token 就是个通信的私钥 $wechatObj
微信公众号消息接入(普通消息+模板消息)
冲出仁川，走出马德里，故事还会再继续
08-25 3948
接入微信公众平台开发，开发者需要按照如下步骤完成： 1、填写服务器配置 2、验证服务器地址的有效性 3、依据接口文档实现业务逻辑 下面详细介绍这3个步骤。（如你已有小程序，并且已开通小程序云开发，也可以使用 公众号环境共享能力，在公众号中使用云开发。）......
Java实现微信公众号开发
最新发布
威哥爱编程，一个坚持研究技术的80后老鸟，擅长后端、AI 大模型、鸿蒙等技术体系，愿与你在技术路上一起成长！
05-17 1469
微信公众平台是运营者通过公众号为微信用户提供资讯和服务的平台，而公众平台开放接口则是提供服务的基础，开发者在公众平台网站中创建公众号、获取接口权限后，可以通过阅读本接口文档来帮助开发。
微信公众号接入开发
hwt1070359898的博客
11-03 1731
目录 前言： 一、公众号中配置 1、获取AppID、AppSecret： 2、配置IP白名单： 问题： 解决： 3、配置JS接口安全域名： 重要：认真阅读系统提示的注意事项： ​ 问题： 解决： 二、前端页面开发： 三、后端服务开发： * 流程： 代码： （1）主要代码： （2）相关代码： 校验工具： 1、appId、secret校验及生成access_token工具：微信公众平台接口调试工具 2、 微信 JS 接口签名校验工具：微信 JS 接口签名校验工具 ..
04 基础接口之接收用户消息开发与实现
weixin_44123412的博客
07-16 184
一、实验要求：  掌握开发模式下消息收发原理；  熟悉接收、发送消息的类型及XML格式；  掌握基于基础消息接口实现公众号服务功能的开发与实现；  掌握微信公众平台开发文档的使用； 三、实验实现过程 1.实验内容：基于微信公众平台测试号，基于接口文件index.php完成利用基础接口接收用户消息并完成“影子回复”，理解微信公众平台接收用户消息及被动回复用户消息的原理，并利用流程图的形式给出接口代码的逻辑分析。具体如下： ①　请登录微信官网：http://mp.weixin.qq.com 进入后台-开
微信公众号api关注接口php,微信公众平台接口开发入门示例
weixin_33941859的博客
03-09 1902
本文实例讲述了微信公众平台接口开发入门示例。分享给大家供大家参考。具体如下：微信公众平台的接口开发是一个现在比较常用的功能了,很多的人都会去了解一下微信公众平台一些简单开发应用,这里就来给大家介绍一个入门示例.这段时间都在忙于微信公众号平台来发,现在已经接近尾声了,所以对于微信开发平台的接口如何使用,在这里也唠刀一两句.微信平台的开发并不像你想像的那么难,无非就是数据的存取处理罢了,对于数据的存取...
微信开发者模式php,微信开发模式（php）
weixin_42356331的博客
03-10 82
才開始学习微信开发模式和PHP，在此记录以供后阅。type=detail&id=1";$resultStr = $this->transmitText( $object, $contentStr, $funcFlag );break;default:break;}return $resultStr;}private function receiveEvent( $object ) {...
微信公众平台开发（一） 配置接口
weixin_33843409的博客
06-05 383
一、简介 微信公众平台是腾讯公司在微信的基础上新增的功能模块，通过这一平台，个人和企业都可以打造一个微信的公众号，并实现和特定群体的文字、图片、语音的全方位沟通、互动。 二、通讯机制 三、注册微信平台公众帐号 注册地址：https://mp.weixin.qq.com 四、服务器端配置 4.1 示例代码设置 微信公众平台提供了一个php示例代码： http://mp.weixi...
Java 微信公众平台开发（一）——开发模式启用及接口配置
那时秋风正爽的博客
08-23 5013
这里开发语言使用的是java，推荐使用认证过的微信公众号或者是微信公众平台测试账号。测试账号登录申请请访问：http://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&amp;amp;amp;amp;amp;amp;amp;amp;amp;amp;amp;amp;t=sandbox/index 一、开发环境的搭建 这里提供两种开发环境： 一是开发测试环境： 1. 使用本地加算计作为服务器，安装好开发环境...
11 公众号开发 - 获取接口调用凭据
阿甘兄
09-06 653
access_token是公众号的全局唯一票据，公众号调用各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的access_token失效。 接口说明 请求方法： https://api.weixin.qq.com/cgi-bin/token?...
微信小游戏的一个demo，小红帽gameDemo-master.zip
09-25
微信小游戏的一个demo，小红帽gameDemo-master.zip
PHP实现微信公众平台开发---提升篇(网页授权接口)
donglingjiu的博客
09-16 8495
网页授权接口(类似于浏览器通过cookie|session标识客户 微信端通过openid标识) 接口类型(通过网页授权 获取openid) snsapi_base:基本类型 静默授权并自动跳转到回调页的。用户感知的就是直接进入了回调页（往往是业务页面） 只获取openid snsapi_userinfo:详细类型 弹出窗口是否授权 需要用户手动同意，并且由于用户同意过，所以无须关注，...
微信公众号开发（八）用户管理
小红帽的博客
09-13 6395
微信公众号开发（八）用户管理 1、设置用户备注名 接口：https://api.weixin.qq.com/cgi-bin/user/info/updateremark?access_token=ACCESS_TOKEN updateremark.php <?php require_once("../Utils.php"); $data = '{ "openid":"o4...
教你3分钟快速开发微信公众号[订阅号][服务号]
码蚁君
06-20 2万+
java微信公众号开发框架 微信开发框架 快速开发
微信公众平台开发1：配置接口
elesos.com
08-11 561
通讯机制 注册地址：https://mp.weixin.qq.com 注：运营主体为个人，只可创建订阅号,不能创建服务号。 而且订阅号只有300元认证后，才能拥有菜单功能（见左侧的微信认证）,而且年审认证需要另行支付审核服务费。 示例代码设置 微信公众平台提供了一个php示例代码：wx-sample.zip 打开编辑，将token
微信公众号---自定义菜单创建接口---创建一级菜单
日光倾城的博客
08-29 1万+
自定义菜单最多包括3个一级菜单 http请求方式：POST（请使用https协议） https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN click和view的请求示例 { "button":[ { "type":"click",
微信开发中消息接收、回复及事件处理通用函数与php语法的详解（index.php文件)
herenoname的博客
09-25 4769
/*     方倍工作室 http://www.fangbei.org/     CopyRight 2015 All Rights Reserved */ header('Content-type:text'); define("TOKEN", "weixin"); //定义TOKEN=weixin $wechatObj = new wechatCallbackapiTest
新版微信-微信公众号一键关注解决办法
热门推荐
小葵的专栏
07-14 4万+
https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzAxNzcwODE2MA==&scene=110#wechat_redirect 注意__biz后面的参数，每一个公众号都有一个唯一的，比如我的就是 MzAxNzcwODE2MA，打开你微信公众号推送的任意一篇文章，复制链接，链接当中就有这样的一个识别码，替换就可以了。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值