微信小程序开发笔记进阶篇⑧——Java后端推送订阅消息 | HTTPS调用，消息卡片，跳转页面

悠悠 2023-10-07 23:48 4阅读 0赞

#### 文章目录 ####

*  一、前言
 *  二、接口说明
 *  三、access\_token 获取
 *  四、消息模板
 *  五、参数page
 *  六、参考

## 一、前言 ##

> [微信小程序开发笔记——导读][Link 1]

> [微信小程序开发笔记 进阶篇⑦——小程序订阅消息 | 发起订阅，获取当前设置][_ _]

>  *  小程序前端做好消息订阅的准备工作
>  *  Java后端将数据按照消息模板的格式，推送给微信用户

> 本博文主要讲述：Java后端如何将数据按照消息模板的格式，推送给微信用户

## 二、接口说明 ##

*  [发送订阅消息 | 微信开放文档][Link 2]
 *  HTTPS 调用
    
     *  `POST https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=ACCESS_TOKEN`
 *  请求参数

<table> 
 <thead> 
  <tr> 
   <th align="left">属性</th> 
   <th>类型</th> 
   <th>必填</th> 
   <th align="left">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">access_token</td> 
   <td>string</td> 
   <td>是</td> 
   <td align="left">接口调用凭证，该参数为 URL 参数，非 Body 参数。使用access_token或者authorizer_access_token</td> 
  </tr> 
  <tr> 
   <td align="left">template_id</td> 
   <td>string</td> 
   <td>是</td> 
   <td align="left">所需下发的订阅模板id</td> 
  </tr> 
  <tr> 
   <td align="left">page</td> 
   <td>string</td> 
   <td>否</td> 
   <td align="left">点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数,（示例index?foo=bar）。该字段不填则模板无跳转</td> 
  </tr> 
  <tr> 
   <td align="left">touser</td> 
   <td>string</td> 
   <td>是</td> 
   <td align="left">接收者（用户）的 openid</td> 
  </tr> 
  <tr> 
   <td align="left">data</td> 
   <td>string</td> 
   <td>是</td> 
   <td align="left">模板内容，格式形如 { “key1”: { “value”: any }, “key2”: { “value”: any } }的object</td> 
  </tr> 
  <tr> 
   <td align="left">miniprogram_state</td> 
   <td>string</td> 
   <td>是</td> 
   <td align="left">跳转小程序类型：developer为开发版；trial为体验版；formal为正式版；默认为正式版</td> 
  </tr> 
  <tr> 
   <td align="left">lang</td> 
   <td>string</td> 
   <td>是</td> 
   <td align="left">进入小程序查看”的语言类型，支持zh_CN(简体中文)、en_US(英文)、zh_HK(繁体中文)、zh_TW(繁体中文)，默认为zh_CN</td> 
  </tr> 
 </tbody> 
</table>

*  返回参数

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>类型</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>errcode</td> 
   <td>number</td> 
   <td>错误码</td> 
  </tr> 
  <tr> 
   <td>errmsg</td> 
   <td>string</td> 
   <td>错误信息</td> 
  </tr> 
 </tbody> 
</table>

public static JSONObject getBillData(Bill bill){
        
        JSONObject createTime = new JSONObject();
        createTime.put("value", DateUtils.parseDateToStr("yyyy/MM/dd HH:mm:ss", bill.getCreateTime()));
    
        JSONObject houseName = new JSONObject();
        houseName.put("value", bill.getTenantHouseName());
    
        JSONObject landlordName = new JSONObject();
        landlordName.put("value", bill.getLandlordName());
    
        JSONObject totalCost = new JSONObject();
        totalCost.put("value", bill.getTotalCost()+"元");
    
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("time5", createTime);
        jsonObject.put("thing1", houseName);
        jsonObject.put("thing2", landlordName);
        jsonObject.put("amount3", totalCost);
        log.info(jsonObject.toJSONString());
        return jsonObject;
    }
    
    public static JSONObject sentBillMessage(RestTemplateUtils restTemplateUtils, User user, Bill bill){
        
        try {
        
            String accessToken = getAccessToken(TENANT_APPID);
            JSONObject paramMap = new JSONObject();
            paramMap.put("access_token", accessToken);
            paramMap.put("touser", user.getTenantOpenId());
            paramMap.put("template_id", "zrnNqXdbDZFVlhEew5LfQ2nOW8pUG5CdJ4Vw1J__S5Q");
            paramMap.put("data", getBillData(bill));
            paramMap.put("page", "pages/main/main");
    
            JSONObject body = restTemplateUtils.getRestTemplate().postForEntity("https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token="+accessToken, paramMap, JSONObject.class).getBody();
            log.info(body.toJSONString());
            return body;
        }catch (Exception e){
        
            e.printStackTrace();
            log.error("sentMessage bill="+bill.toString()+", user="+ user.toString());
        }
        return null;
    }

## 三、access\_token 获取 ##

*  [获取接口调用凭据| 微信开放文档][Link 3]

public static String getAccessToken(String appId){
        
        String objectStr="";
        try {
        
            objectStr = HttpUtil.get(String.format("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=%s&secret=%s",appId, getAppSecret(appId)));
            JSONObject jsonObject = JSON.parseObject(objectStr);
            return jsonObject.getString("access_token");
        }catch (Exception e){
        
            e.printStackTrace();
        }
        return null;
    }

## 四、消息模板 ##

*  登录[小程序][Link 4]
 *  功能—>订阅消息
 *  选用模块，复制模板ID

![在这里插入图片描述][a1986b1f366b4a15bbac8157d1ad9ac7.png]

![在这里插入图片描述][0f36a4c4859e4c34b879a96128bd6ba5.png]

## 五、参数page ##

*  `page`参数不填的话，默认否。即没有`进入小程序查看`的按钮

![在这里插入图片描述][4221344e038d4fc88182996cb3f8cb57.png]

![在这里插入图片描述][1ae08f8697b041b2b76cbbce4ec107b0.png]

## 六、参考 ##

*  [发送订阅消息 | 微信开放文档][Link 2]
 *  [获取接口调用凭据| 微信开放文档][Link 3]

***觉得好，就一键三连呗（点赞+收藏+关注）***

[Link 1]: https://blog.csdn.net/kangweijian/article/details/122036953
[_ _]: https://blog.csdn.net/kangweijian/article/details/128999766
[Link 2]: https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/mp-message-management/subscribe-message/sendMessage.html
[Link 3]: https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/mp-access-token/getAccessToken.html
[Link 4]: https://mp.weixin.qq.com/
[a1986b1f366b4a15bbac8157d1ad9ac7.png]: https://img-blog.csdnimg.cn/a1986b1f366b4a15bbac8157d1ad9ac7.png
[0f36a4c4859e4c34b879a96128bd6ba5.png]: https://img-blog.csdnimg.cn/0f36a4c4859e4c34b879a96128bd6ba5.png
[4221344e038d4fc88182996cb3f8cb57.png]: https://img-blog.csdnimg.cn/4221344e038d4fc88182996cb3f8cb57.png
[1ae08f8697b041b2b76cbbce4ec107b0.png]: https://img-blog.csdnimg.cn/1ae08f8697b041b2b76cbbce4ec107b0.png