微信小程序二维码

一、获取小程序码的三个接口

不同的接口对应不同的业务场景,接口B用的较多,接口C官方不推荐使用,也就是说根据需码量来决定选择A接口还是B接口。

(1)、接口 A: 适用于需要的码数量较少的业务场景
生成小程序码,可接受 path 参数较长,生成个数受限

接口A文档

(1)、接口 B:适用于需要的码数量极多的业务场景
生成小程序码,可接受页面参数较短,生成个数不受限.

接口B文档

就以接口B来展开说明

二、思路介绍

(1)、获取 ACCESS_TOKEN 凭证。

image

获取Access token 文档

根据文档可以看出来,一个Token最多可用2小时并且只能存在一个可用Token,即使本Token并没有失效,再次获取新的Token也会使上一个Token失效。

为了保证高可用,不能2小时刷新一次token吧,太呆逼。可以1个半小时刷新一次,获取Token存入Redis,如果Redis中获取不到就重新获取Token存入Redis。

(2)、带参入码

请求方式
POST https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=你的微信Token

参数
image

常用的有 scenepage 其他的具体细节并不做过多控制

scene传参有些许特殊

{
 "scene": "a=1"
}

多个参数 :scene=shop=382number=3这样传 有的手机就把 = 转义了,有的没有,所以定义统一解析规则 a=1 改为 az1 或者 ak1等等 由前端去拆分字符解析

(3)、保存图片

操作成功后 返回的图片 Buffer 而不是图片地址,因此需要做一些处理,保存到本地、然后上传到服务器

(4)、异常处理

失败的话会返回错误码,根据具体的错误码去做处理
image

如果是Token失效所导致的异常40001,就在获取一遍Token重新执行操作,提高容错率,保证高可用

三、编码

(1)、获取 ACCESS_TOKEN 凭证。

开发环境一般都有配置Redis头,实例代码并不规范,仅供参考。

    //从Yml配置文件读取关于微信的配置
    @Resource
    private WechatConfig wxConfig;
    
    @Override
    public String getWeChatToken() throws IOException {
        //1、从Redis获取微信的Token
        String accessToken = RedisHelper.get(RedisKey.getKey("存入的微信Token"));
        //2、不为空则返回Redis中的微信Token
        if (StringUtils.isNotBlank(accessToken)) {
            return accessToken;
        }
        //3、为空则获取Token
        accessToken = this.obtainToken();
        return accessToken;
    }

    /**
     * 获取 access_token
     */
    @Override
    public synchronized String obtainToken() throws IOException {
        //1、从配置文件读取到下面的参数 并发送Get请求就可以获取到Token
        String getToken = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET";
        //2、获取到请求的结果转成指定的格式
        //(接口只返回access_token和错误码expires_in,因此该param只封装这两个参数)
        returnTokenParam token = JSONObject.parseObject(s, returnTokenParam .class);
        String accessToken = token .getAccessToken();
        //3、获取Token成功存入Redis 失败抛出异常,当然也可以做异常处理
        if ("".equals(accessToken) || StringUtils.isBlank(accessToken)) {
            log.error("获取微信Access_Token失败");
            throw new BizException(ErrorCode.WECHAT_ACCESSTOKEN_ERROR);
        }
        RedisHelper.set(token自定义名称, accessToken, 过期时间 60*60*30 1个半小时);
        return accessToken;
    }

(2)、带参入码、异常处理

        //1、校验,准备参数
        //因Token只能生效一个所以 非线上环境不去获取token
        //(逻辑~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
        //生成的用户邀请小程序码会被持久化,查询是否持久化,是的话返回结果
        //(逻辑~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
        //获取微信accessToken
        String accessToken = 第一步的getWeChatToken();
        
        //2、创建请求参数
        JSONObject params = new JSONObject();
        //让前端通过 "y" 解析参数  也可以是别的
        params.put("scene","cy"+customer.getRecommendCode());
        //扫码后进入小程序的页面位置(从yml读)
        params.put("page", page);

        //3、发起 post json请求 (按自己的方式发请求,接收结果就行)
        Response response = 你自己的请求工具类.POST请求("https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=" + accessToken, params);

        //4、获取结果进行处理(成功默认返回image/jpeg)
        String contentType = response.header("Content-Type");
        if (!"image/jpeg".equals(contentType)) {
            //处理错误(获取返回结果的body)
            String body = response.body().string();
            JSONObject jsonObject = new JSONObject(body);
            String errcode = jsonObject.get("errcode").toString();
            //如果为 40001 错误码 极可能是token出现问题,保证高可用再去重新获取
            if (!"40001".equals(errcode)) {
                String errmsg = jsonObject.get("errmsg").toString();
                log.error("记录错误日志");
                //抛出异常
                throw new .....;
            }
            //重新获取token
            accessToken = 第一步的getWeChatToken();
            //重新发起 post json请求
            Response response = 你自己的请求工具类.POST请求("https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=" + accessToken, params);
            //获取结果进行处理
            contentType = response.header("Content-Type");
            if (!"image/jpeg".equals(contentType)) {
                String errmsg = jsonObject.get("errmsg").toString();
                log.error("记录错误日志");
                //抛出异常
                throw new .....;
            }
        }

        //5、保存图片
        saveToImgByInputStream(得到的流,保存路径)
        //上传到服务器
        //(逻辑~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)
        //持久化图片地址
        //(逻辑~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~)

3、保存图片

/**
     * 将二进制转换成文件保存
     * @param instreams 二进制流
     * @param imgPath 图片的保存路径
     * @return
     *      1:保存正常
     *      0:保存失败
     */
    public static int saveToImgByInputStream(InputStream instreams, String imgPath){
        int stateInt = 1;
        if(instreams != null){
            try {
                //可以是任何图片格式.jpg,.png等
                File file = new File(imgPath);
                FileOutputStream fos=new FileOutputStream(file);
                byte[] b = new byte[1024];
                int nRead = 0;
                while ((nRead = instreams.read(b)) != -1) {
                    fos.write(b, 0, nRead);
                }
                fos.flush();
                fos.close();
            } catch (Exception e) {
                stateInt = 0;
                e.printStackTrace();
            }
        }
        //1 成功,0 失败
        return stateInt;
    }

一定不能忘了,微信Token只能同时存在一个,且过期时间默认走最大时间(2小时)

posted @ 2021-08-31 14:51  迷途者寻影而行  阅读(488)  评论(0编辑  收藏  举报