企业微信-服务商后台绑定小程序时，指令回调、数据回调、测试安装

1、企业微信API文档

https://work.weixin.qq.com/api/doc/90001/90142/90595 服务商注册应用

https://work.weixin.qq.com/api/doc/90001/90145/90446 加解密库下载与返回码

下载JAVA库json版本

image

拷贝aes文件夹到自己的工程

image

2、指令回调、数据回调、测试安装接口

import cn.hutool.json.JSONObject;
import cn.hutool.json.JSONUtil;

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestController;

/**
 * 微信缓存表 前端控制器
 */
@Slf4j
@RestController
@RequestMapping("api/admin/qywechat")
public class QyWeChatController {

    /**
     * ------------企业微信验证回调URL---------------
     * 企业开启回调模式时，企业微信会向验证url发送一个get请求
     * 假设点击验证时，企业收到类似请求：
     * GET /cgi-bin/wxpush?msg_signature=5c45ff5e21c57e6ad56bac8758b79b1d9ac89fd3×tamp=1409659589&nonce=263014780&echostr=P9nAzCzyDtyTWESHep1vC5X9xho%2FqYX3Zpb4yKa9SKld1DsH3Iyt3tP3zNdtp%2B4RPcs8TgAE7OaBO%2BFZXvnaqQ%3D%3D
     * HTTP/1.1 Host: qy.weixin.qq.com
     * 

     * 接收到该请求时，企业应      1.解析出Get请求的参数，包括消息体签名(msg_signature)，时间戳(timestamp)，随机数字串(nonce)以及企业微信推送过来的随机加密字符串(echostr),
     * 这一步注意作URL解码。
     * 2.验证消息体签名的正确性
     * 3. 解密出echostr原文，将原文当作Get请求的response，返回给企业微信
     * 第2，3步可以用企业微信提供的库函数VerifyURL来实现。
     */
    @RequestMapping(value = "/dataCallback")
    @ResponseBody
    public String dataCallback(@RequestBody(required = false) String reqStr, QyWechatCallBackReq req) throws AesException {



        //需要返回的明文
        String sEchoStr = null;

        // post 请求，用于测试安装
        if (null != reqStr) {

             //第三方应用SuiteIDID
            String SuiteID = "";

            String sToken = "";
   
            String sEncodingAESKey = "";

            JSONObject jsonObject = JSONUtil.xmlToJson(reqStr);
            String xmlData = JSONUtil.toJsonStr(jsonObject.get("xml"));

            log.info("指令回调请求参数xmlData：{}", xmlData);
            // 对msg_signature进行检验 并且解密获得消息结构体
            WXBizJsonMsgCrypt wxcpt = new WXBizJsonMsgCrypt(sToken, sEncodingAESKey, SuiteID);
          
            // 回调的key值
            String msgStructure = wxcpt.DecryptMsg(req.getMsg_signature(), req.getTimestamp(), req.getNonce(), xmlData);
           
            log.info("指令回调获取到的数据为:{}", msgStructure);
            return "success";

        } else {
            // get 请求，用于验证回调

            //服务商CORPID
            String sCorpID = "";

            String sToken = "";
  
            String sEncodingAESKey = "";

            WXBizJsonMsgCrypt wxcpt = new WXBizJsonMsgCrypt(sToken, sEncodingAESKey, sCorpID);

            // 解析出url上的参数值如下：
            String sVerifyMsgSig = req.getMsg_signature();
            String sVerifyTimeStamp = req.getTimestamp();
            String sVerifyNonce = req.getNonce();
            String sVerifyEchoStr = req.getEchostr();

            try {
                sEchoStr = wxcpt.VerifyURL(sVerifyMsgSig, sVerifyTimeStamp,
                        sVerifyNonce, sVerifyEchoStr);
                log.info("verifyurl echostr: " + sEchoStr);
                // 验证URL成功，将sEchoStr返回
                return sEchoStr;
            } catch (Exception e) {
                //验证URL失败，错误原因请查看异常
                e.printStackTrace();
            }
        }
        return sEchoStr;
    }

}

3、修改JsonParse.java工具类中，json解析时的属性名

image