公众号开发笔记二

约定不等于承诺〃 2021-09-16 18:20 319阅读 0赞

![标题图][1240]

## 前言 ##

微信公众平台开发模板消息,用于公众号向用户发送服务通知,如学生进校门,用校卡滴,就可以在公众号接收服务通知,表明学生进校.在公众号内申请功能,添加模板消息.

只有认证后的服务号才能申请模板消息,需要选择2个行业,`MP`(维基百科，自由的百科全书),模板消息需要模板的`ID`,和模板中各种参数,内容以`".DATA"`结尾,否则视为保留字,模板保留符号`"{ { }}"`.

设置行业可以在公众平台后台完成,接口调用:

这个步骤需要`access_token`

// 请求方式: POST
    https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=ACCESS_TOKEN

数据:

{
        "industry_id1":"1",
        "industry_id2":"4"
    }

> 参数说明

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>access_token</code></td> 
   <td>接口调用凭证</td> 
  </tr> 
  <tr> 
   <td><code>industry_id1</code></td> 
   <td>行业编号</td> 
  </tr> 
  <tr> 
   <td><code>industry_id2</code></td> 
   <td>行业编号</td> 
  </tr> 
 </tbody> 
</table>

行业代码查询:

`https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751277`

获取设置的行业信息:

// 请求方式：GET
    https://api.weixin.qq.com/cgi-bin/template/get_industry?access_token=ACCESS_TOKEN

需要`access_token`接口调用凭证,返回示例:

{
    "primary_industry":{"first_class":"运输与仓储","second_class":"快递"},
    "secondary_industry":{"first_class":"IT科技","second_class":"互联网|电子商务"}
    }

> `primary_industry`: 主营行业  
> `secondary_industry`: 副营行业

获取模板`ID`: 可以在公众平台后获取模板`ID`:

// 请求方式: POST
    https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKEN

需要`access_token`

`post`后的数据:

{
     "template_id_short":"TM00015"
    }

`template_id_short`: 是模板库中模板的编号.

返回模板消息的接口,获取`json`数据:

{
     "errcode":0,
     "errmsg":"ok",
     "template_id":"Doclyl5uP7Aciu-qZ7mJNPtWkbkYnWBWVja26EGbNyk"
    }

> 获取模板列表

获取帐号下所有模板信息:

提供的接口:

// 请求方式：GET
    https://api.weixin.qq.com/cgi-bin/template/get_all_private_template?access_token=ACCESS_TOKEN

返回的数据:

![图1][1]

调用接口进行删除某账号下的模板:

// 请求方式：POST
    
    https://api.weixin.qq.com/cgi-bin/template/del_private_template?access_token=ACCESS_TOKEN
    
    POST数据说明如下：
    
     {
         "template_id" : "Dyvp3-Ff0cnail_CDSzk1fIc6-9lOkxsQE7exTJbwUE"
     }

`template_id`: 模板消息ID

删除成功:

{
       "errcode" : 0,
       "errmsg" : "ok"
    }

#### 发送模板消息 ####

调用接口:

// 请求方式: POST
    https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

![图2][2]

需要:

OPENID
    template_id
    url
    miniprogram

![图3][3]

调用模板消息接口成功:

{
    "errcode":0,
    "errmsg":"ok",
    "msgid":200228332
    }

#### 事件推送 ####

消息模板发送成功到公众号,微信服务器会将是否发送成功作为通知到开发者中心的服务器配置地址中.

推送`xml`代码:

![图4][4]

![图5][5]

![图6][6]

#### 模版消息接口文档 ####

`https://www.cnblogs.com/jiqing9006/p/5220571.html`

对模板进行查看详情:

![图7][7]

#### \# [可向指定openID群发][openID] ####

`https://segmentfault.com/a/1190000012828138`

#### `php`的实现 ####

`https://www.cnblogs.com/jiqing9006/p/5220571.html`

1.  实例化 --> 获取`appid,appsecret`
2.  获取`access_token`
3.  发送模板消息
4.  组合消息数据
5.  获取`openid`, 并发送消息

发送模板消息的接口:

`https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN`

发送模板的方法:

//发送模板消息的接口
        public static final String SEND_TEMPLATE_URL = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN";
        /**
         * 发送模板
         *
         */
        public static void sendTemplate(String data){
            String result = HttpUtil.post(SEND_TEMPLATE_URL.replace("ACCESS_TOKEN", getAccessToken()),data);
            System.out.println(result);
        }

`getAccessToken`的方法:

#### 验证接入 ####

![图8][8]

#### 微信公众平台接口测试帐号申请 ####

`https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login`

公众号开发:

`appid`和`appsecret`

配置参数: `URL`(自己的服务器地址)和`Token`(可任意填写)

![图9][9]

使用java语言，SpringMVC+Spring+MyBatis框架

保证`url`的有效性:

![图10][10]

![图11][11]

代码示例：

@Controller
    public class WeChatController {
            /**
             * 微信URL接入验证
             * @param signature
             * @param timestamp
             * @param nonce
             * @param echostr
             * @return
             */
            @RequestMapping(value="/weChat",method= RequestMethod.GET)
            @ResponseBody
            public String validate(String signature,String timestamp,String nonce,String echostr){
                //1. 将token、timestamp、nonce三个参数进行字典序排序
                String[] arr = {timestamp,nonce,WeChatUtil.TOKEN};
                Arrays.sort(arr);
                //2. 将三个参数字符串拼接成一个字符串进行sha1加密
                StringBuilder sb = new StringBuilder();
                for (String temp : arr) {
                   sb.append(temp);
                }
                //3. 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信
                if(SecurityUtil.SHA1(sb.toString()).equals(signature)){
                    //接入成功
                    return echostr;
                }
                //接入失败
                return null;
            }
    }

WeChatUtil.TOKEN是常量要与填入的token值相同
    SecurityUtil是工具类,提供sha1加密方法

#### 获取access\_token ####

public class WeChatUtil {
        //URL验证时使用的token
        public static final String TOKEN = "wolfcode";
        //appid
        public static final String APPID = "wx59687be81dd3d388";
        //secret
        public static final String SECRET = "d4624c36b6795d1d99dcf0547af5443d";
            //创建菜单接口地址
        public static final String CREATE_MENU_URL = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN";
        //获取access_token的接口地址
        public static final String GET_ACCESSTOKEN_URL = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET";
        //缓存的access_token
        private static String accessToken;
        //access_token的失效时间
        private static long expiresTime;
     
        /**
         * 获取accessToken
         * @return
         */
        public static String getAccessToken(){
            //判断accessToken是否已经过期，如果过期需要重新获取
            if(accessToken==null||expiresTime < new Date().getTime()){
                //发起请求获取accessToken
                String result = HttpUtil.get(GET_ACCESSTOKEN_URL.replace("APPID", APPID).replace("APPSECRET", SECRET));
                //把json字符串转换为json对象
                JSONObject json = JSON.parseObject(result);
                //缓存accessToken
                accessToken = json.getString("access_token");
                //设置accessToken的失效时间
                long expires_in = json.getLong("expires_in");
                //失效时间 = 当前时间 + 有效期(提前一分钟)
                expiresTime = new Date().getTime()+ (expires_in-60) * 1000;
            }
            return accessToken;
        }
    }

`HttpUtil`是发起`http`请求的工具类

`https://blog.csdn.net/frankcheng5143/article/details/50070591`

官方文档中的示例:

//1.获得一个httpclient对象
    CloseableHttpClient httpclient = HttpClients.createDefault();
    //2.生成一个get请求
    HttpGet httpget = new HttpGet("http://localhost/");
    //3.执行get请求并返回结果
    CloseableHttpResponse response = httpclient.execute(httpget);
    try {
        //4.处理结果
    } finally {
        response.close();
    }

`HttpGet`和`HttpPost`

## 发送`HttpGet` ##

/**
    	 * 发送HttpGet请求
    	 * @param url
    	 * @return
    	 */
    	public static String sendGet(String url) {
    		//1.获得一个httpclient对象
    		CloseableHttpClient httpclient = HttpClients.createDefault();
    		//2.生成一个get请求
    		HttpGet httpget = new HttpGet(url);
    		CloseableHttpResponse response = null;
    		try {
    			//3.执行get请求并返回结果
    			response = httpclient.execute(httpget);
    		} catch (IOException e1) {
    			e1.printStackTrace();
    		}
    		String result = null;
    		try {
    			//4.处理结果，这里将结果返回为字符串
    			HttpEntity entity = response.getEntity();
    			if (entity != null) {
    				result = EntityUtils.toString(entity);
    			}
    		} catch (ParseException | IOException e) {
    			e.printStackTrace();
    		} finally {
    			try {
    				response.close();
    			} catch (IOException e) {
    				e.printStackTrace();
    			}
    		}
    		return result;
    	}

## 发送HttpPost ##

/**
    	 * 发送不带参数的HttpPost请求
    	 * @param url
    	 * @return
    	 */
    	public static String sendPost(String url) {
    		//1.获得一个httpclient对象
    		CloseableHttpClient httpclient = HttpClients.createDefault();
    		//2.生成一个post请求
    		HttpPost httppost = new HttpPost(url);
    		CloseableHttpResponse response = null;
    		try {
    			//3.执行get请求并返回结果
    			response = httpclient.execute(httppost);
    		} catch (IOException e) {
    			e.printStackTrace();
    		}
    		//4.处理结果，这里将结果返回为字符串
    		HttpEntity entity = response.getEntity();
    		String result = null;
    		try {
    			result = EntityUtils.toString(entity);
    		} catch (ParseException | IOException e) {
    			e.printStackTrace();
    		}
    		return result;
    	}

`HttpClient`通过`UrlEncodedFormEntity`提交带参数的请求

![图12][12]

使用`apache`的`HttpClient`发送`post`请求

`https://blog.csdn.net/xiaoyaoyulinger/article/details/77315694`

`JAVA http`请求工具类`http-request`

`https://www.jianshu.com/p/e955b01e2e16`

## 获取微信用户信息 ##

`https://blog.csdn.net/wolfcode_cn/article/details/80755359`

![图13][13]

两种scope授权作用域  
配置授权域名

引导用户打开授权界面:

`https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect`

![图14][14]

用`code`来获取网页授权专用的`access_token`凭据

地址:

`https://blog.csdn.net/wolfcode_cn/article/details/80755359`

> 达叔小生：往后余生，唯独有你  
> You and me, we are family !  
> 90后帅气小伙，良好的开发习惯；独立思考的能力；主动并且善于沟通  
> 简书博客： 达叔小生  
> [https://www.jianshu.com/u/c785ece603d1][https_www.jianshu.com_u_c785ece603d1]

## 结语 ##

*  下面我将继续对 其他知识 深入讲解 ，有兴趣可以继续关注
 *  小礼物走一走 or 点赞

[1240]: /images/20210724/0c80c5628c7446178e1bed01ca487349.png
[1]: /images/20210724/d7d5d45bdb144bc89d18f8b1bda5bbe2.png
[2]: /images/20210724/e3b0f76031ab41a7ac084c7722241483.png
[3]: /images/20210724/2ebdd7df2e4440eda9e9bbed2c605f95.png
[4]: /images/20210724/43a4b485df0d43e1a68d11c0b635871e.png
[5]: /images/20210724/261ed71600f14d0cbcf3dc324e80300f.png
[6]: /images/20210724/24e991af693646c1b732d47b56fd644c.png
[7]: /images/20210724/a97390fd448343e4b7df55cf676bcb82.png
[openID]: https://segmentfault.com/a/1190000012828138
[8]: /images/20210724/ed277c71c85b4354aa132301782dd0c3.png
[9]: /images/20210724/27a035bf17c54d6ba40c74fc4b4a1f60.png
[10]: /images/20210724/1c45dff2cab24f25a105a6c257e1c704.png
[11]: /images/20210724/d3cae5ece6ba4eed855a014734152d52.png
[12]: /images/20210724/84744c50895a470da763859e4a9077c1.png
[13]: /images/20210724/2e8b0d236acb4e189c8637296af76bc9.png
[14]: /images/20210724/65196bf510454f6a9fdec8851a9fd2fa.png
[https_www.jianshu.com_u_c785ece603d1]: https://www.jianshu.com/u/c785ece603d1