微信公众平台服务号API开发接口

微信公众平台服务号 API 开发接口

目录：

简介................................................................................................................................................................1

申请消息接口...............................................................................................................................................1

接收用户消息...............................................................................................................................................5

文本消息...............................................................................................................................................5

语音消息...............................................................................................................................................8

视频消息...............................................................................................................................................9

回复音乐消息.....................................................................................................................................17

回复图文消息.....................................................................................................................................18

接收事件推送.............................................................................................................................................19

关注/取消关注事件............................................................................................................................19

自定义菜单事件.................................................................................................................................25

自定义菜单.................................................................................................................................................26

自定义菜单创建.................................................................................................................................26

自定义菜单查询.................................................................................................................................37

自定义菜单删除.................................................................................................................................46

示例代码.....................................................................................................................................................55

网址接入

公众平台用户提交信息后，微信服务器将发送 GET 请求到填写的 URL 上，并且带上

四个参数：

参数 描述

signature

微信加密签名 signature 结合了开发者填写的 token 参数

和请求中的 timestamp 参数、nonce 参数。

timestamp

时间戳

nonce

加密/校验流程：

1. 将 token、timestamp、nonce 三个参数进行字典序排序

2. 将三个参数字符串拼接成一个字符串进行 sha1 加密

3. 开发者获得加密后的字符串可与 signature 对比，标识该请求来源于微信

具体方法如下：

首先下载官方事例 demo 内容如下：

<?php

/**

* wechat php test

*/

public function valid()

{

$echoStr = $_GET["echostr"];

//valid signature , option

if($this->checkSignature()){

echo $echoStr;

exit;

}

}

public function responseMsg()

$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);

$fromUsername = $postObj->FromUserName;

$toUsername = $postObj->ToUserName;

$keyword = trim($postObj->Content);

$time = time();

$textTpl = "<xml>

<ToUserName><![CDATA[%s]]></ToUserName>

<FromUserName><![CDATA[%s]]></FromUserName>

<CreateTime>%s</CreateTime>

<MsgType><![CDATA[%s]]></MsgType>

$contentStr = "Welcome to wechat world!";

$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType,

$contentStr);

echo $resultStr;

}else{

echo "Input something...";

}

}else {

echo "";

exit;

$nonce = $_GET["nonce"];

$token = TOKEN;

$tmpArr = array($token, $timestamp, $nonce);

sort($tmpArr);

$tmpStr = implode( $tmpArr );

$tmpStr = sha1( $tmpStr );

return true;

}else{

return false;

}

}

}

?>

这里的 dene("TOKEN", "weixin");值就是你申请接口配置信息。

接口配置 URL 必须访问当前脚本才能完成网址接入。

只有配置了正确的 Token 值，然后才能上传文件到自己的服务器上。这时你所设置

中以文本消息最为常用，这里着重以文本消息介绍，结构如下：

文本消息

就是说当用户给公众平台发文本消息时，消息的格式：

<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>