微信公众号"发送一次性订阅消息"接口的使用
最近，微信新增了发送一次性订阅消息的接口，便使用php做了一个测试案例，希望可以给大家帮助。微信发送一次性订阅消息的规范 ：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1500374289_66bvB
发送一次性订阅消息有两个步骤：
第一步：需要用户同意授权，获取一次给用户推送一条订阅模板消息的机会
第二步：通过API推送订阅模板消息给到授权微信用户
接下来，我就附上我的代码，然后给大家讲解一下
/**
* 获取授权发送一次性订阅接口接口
*/
public function getSubscribemsg()
{
redirect("https://mp.weixin.qq.com/mp/subscribemsg?action=get_confirm&appid=wxee6a581d613debee&scene=1000&template_id=ZydnrAeuYY4kPcImQTe3J81TDLUsSioKBQYvAwG4OwI&redirect_url=http%3a%2f%2fsslkg.xnit.net%2findex.php%2fhome%2fCom%2fsubscribemsg&reserved=test#wechat_redirect");
}
/**
* 发送一次性订阅接口
*/
public function subscribemsg()
{
$action = $_GET['action'];
if ($action == "confirm") {
$openid = $_GET['openid'];
$template_id = $_GET['template_id'];
$scene = $_GET['scene'];
$access_token = $this->get_access_tokenjs();
$url = "https://api.weixin.qq.com/cgi-bin/message/template/subscribe?access_token={$access_token}";
$postdata = "{"
. "\"touser\": \"" . $openid . "\","
. "\"template_id\":\"" . $template_id . "\","
. "\"url\": \"https://www.baidu.com\","
. "\"scene\": \"".$scene."\","
. "\"title\": \"t\","
. "\"data\": {"
. "\"content\": {"
. "\"value\": \"订阅消息测试\","
. "\"color\": \"blue\""
. "}"
. "}"
. "}";
$ch1 = curl_init();
$timeout = 3000;
curl_setopt($ch1, CURLOPT_URL, $url);
curl_setopt($ch1, CURLOPT_POST, 1);
curl_setopt($ch1, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch1, CURLOPT_CONNECTTIMEOUT, $timeout);
curl_setopt($ch1, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($ch1, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch1, CURLOPT_POSTFIELDS, $postdata);
$result = curl_exec($ch1);
curl_close($ch1);
$result = json_decode($result, true);
$errcode = $result['errmsg'];
$this->error($errcode, "/Houses/houselist");
}
}
参数说明
| 参数 |
是否必须 | 说明 |
| action | 是 | 直接填get_confirm即可 |
| appid | 是 |
公众号的唯一标识 |
| scene | 是 | 重定向后会带上scene参数，开发者可以填0-10000的整形值，用来标识订阅场景值 |
| template_id | 是 | 订阅消息模板ID，登录公众平台后台，在接口权限列表处可查看订阅模板ID |
| redirect_url | 是 | 授权后重定向的回调地址，请使用UrlEncode对链接进行处理。注：要求redirect_url的域名要跟登记的业务域名一致，且业务域名不能带路径。业务域名需登录公众号，在设置-公众号设置-功能设置里面对业务域名设置。 |
| reserved | 否 | 用于保持请求和回调的状态，授权请后原样带回给第三方。该参数可用于防止csrf攻击（跨站请求伪造攻击），建议第三方带上该参数，可设置为简单的随机数加session进行校验，开发者可以填写a-zA-Z0-9的参数值，最多128字节 |
| #wechat_redirect | 是 | 无论直接打开还是做页面302重定向时，必须带此参数 |
redirect_url参数对应第二个方法的访问路径，这个路径需要经过urlencoding编码
用户同意或取消授权后会返回相关信息
如果用户点击同意或取消授权，页面将跳转至：
redirect_url/?openid=OPENID&template_id=TEMPLATE_ID&action=ACTION&scene=SCENE
参数说明
| 参数 | 说明 |
| openid | 用户唯一标识，只在用户确认授权时才会带上 |
| template_id | 订阅消息模板ID |
| action | 用户点击动作，”confirm”代表用户确认授权，”cancel”代表用户取消授权 |
| scene | 订阅场景值 |
| reserved | 请求带入原样返回 |
subscribemsg()方法就是根据返回数据去发送一次性订阅信息，我们在subscribemsg()方法里获取以上返回的数据，然后拼成json格式的数据，发送数据到下面的接口。
接口请求说明
http请求方式: post
https://api.weixin.qq.com/cgi-bin/message/template/subscribe?access_token=ACCESS_TOKEN
post数据示例
{
“touser”:”OPENID”,
“template_id”:”TEMPLATE_ID”,
“url”:”URL”,
“scene”:”SCENE”,
“title”:”TITLE”,
“data”:{
“content”:{
“value”:”VALUE”,
“color”:”COLOR”
}
}
}
参数说明
| 参数 | 是否必须 | 说明 |
| touser | 是 | 填接收消息的用户openid |
| template_id | 是 | 订阅消息模板ID |
| url | 否 | 点击消息跳转的链接，需要有ICP备案 |
| scene | 是 | 订阅场景值 |
| title | 是 | 消息标题，15字以内 |
| data | 是 | 消息正文，value为消息内容文本（200字以内），没有固定格式，可用\n换行，color为整段消息内容的字体颜色（目前仅支持整段消息为一种颜色） |
返回说明
在调用接口后，会返回JSON数据包。正常时的返回JSON数据包示例：
{
“errcode”:0,
“errmsg”:”ok”
}
1. errmsg 返回的信息是data format error hint,这个问题主要是数据格式不正确，在这里，我需要插一句，我在做这个的时候，发现微信接口说明里
说的”value为消息内容文本（200字以内），没有固定格式，可用\n换行“，我发现如果在value参数里写上\n，就会报错，所以，我不知道是还未提供，
还是哪里出了问题，如果各位知道了，希望告知一声。
2. errmsg 返回的信息是user refuse to accept the msg hint: [5aw330620ge21]，一次性订阅接口并不是说会员订阅一次后就能不断的推送消息，
而是说会员订阅一次后你只能推送一条，如果想再次推送，需要再一次订阅，这点要先搞明白，如果你想尝试一次订阅多次推送。
我在测试过程中也遇到了这个问题，后面发现是因为我没有给scene赋值，所以，获取到返回数据之后，一定要把scene参数上传。希望可以给各位一些
帮助。如果各位发现其中有什么问题，希望可以指出，谢谢！