您的当前位置:首页正文

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

2024-11-06 来源:个人技术集锦

一、前言

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

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

二、接口说明

  • HTTPS 调用
    • POST https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=ACCESS_TOKEN
  • 请求参数
属性类型必填说明
access_tokenstring接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token
template_idstring所需下发的订阅模板id
pagestring点击模板卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例index?foo=bar)。该字段不填则模板无跳转
touserstring接收者(用户)的 openid
datastring模板内容,格式形如 { “key1”: { “value”: any }, “key2”: { “value”: any } }的object
miniprogram_statestring跳转小程序类型:developer为开发版;trial为体验版;formal为正式版;默认为正式版
langstring进入小程序查看”的语言类型,支持zh_CN(简体中文)、en_US(英文)、zh_HK(繁体中文)、zh_TW(繁体中文),默认为zh_CN
  • 返回参数
属性类型说明
errcodenumber错误码
errmsgstring错误信息
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 获取

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

四、消息模板

  • 登录
  • 功能—>订阅消息
  • 选用模块,复制模板ID

五、参数page

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

六、参考

觉得好,就一键三连呗(点赞+收藏+关注)

Top