对接企业微信上架第三方应用_JAVA

左手的ㄟ右手 2023-05-28 09:50 23阅读 0赞

# 一.创建应用 #

登录服务商平台->应用管理->应用开发->网页应用->创建应用

具体地址[https://open.work.weixin.qq.com/wwopen/developer\#/sass/apps/list][https_open.work.weixin.qq.com_wwopen_developer_sass_apps_list]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70][]

1.配置基础信息

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 1][]

3.配置开发信息

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 2][]

注：除了圈红线的url，其他的都能从旁边的详细解释看的懂。当然这两个url可以创建完成之后再进行更改调试。

点击创建完成。

# 二.编辑回调配置 #

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 3][]

*  这里需要我们正确的响应微信服务调用，微信会通过下面我们配置的两个url进行传参调用，我们需要根据TOKEN、ENCODING\_AES\_KEY、CORP\_ID等参数（CORP\_ID可以在服务商信息找到）生成加、解密的接口的实例，再将从微信发起的请求中获取对应的参数，就可以解析出相应的信息。

微信开发官方指南[https://work.weixin.qq.com/api/doc/90001/90143/91116][https_work.weixin.qq.com_api_doc_90001_90143_91116]

*   编写接口响应回调

入参如下图所示

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 4][]

需要引用到的jar下载地址

https://work.weixin.qq.com/api/doc/90001/90145/90446\#java库

实现代码参考：

@ResponseBody
    @RequestMapping("wx/callback")
        public String callback(HttpServletRequest request, HttpServletResponse response) {
    
            String resData = "";
            try {
                boolean getFlag = GET.equals(request.getMethod().toLowerCase());
                String signature = request.getParameter(MSG_SIGNATURE);
                String timestamp = request.getParameter(TIMESTAMP);
                String nonce = request.getParameter(NONCE);
                String sVerifyEchoStr = request.getParameter(ECHOSTR);
    
                //数据回调URL
                if (getFlag) {
                    resData = this.verifyUrl(signature, timestamp, nonce, sVerifyEchoStr);
                    return resData;
    }
    
    
    private String verifyUrl(String signature, String timestamp, String nonce, String sVerifyEchoStr) throws Exception {
            WXBizMsgCrypt wxCpt = new WXBizMsgCrypt(TOKEN, ENCODING_AES_KEY, CORP_ID);
            logger.info("------开始进行数据回调URL--------");
            logger.info(String.format("msg_signature=%s&timestamp=%s&nonce=%s&echostr=%s",
                    signature, timestamp, nonce, sVerifyEchoStr));
            //解密
            String resData = wxCpt.VerifyURL(signature, timestamp,
                    nonce, sVerifyEchoStr);
            logger.info("-------数据回调URL结束------------返回的字符串: " + resData);
            return resData;
        }

点击申请校验会出现正确响应该次请求的日志

![20200325180542274.png][]

注：

1.如出现异常java.security.InvalidKeyException:illegal Key Size

![20200325180542315.png][]

2.配置指令回调url、数据回调url这两个是一个请求。

（这里保留疑问，因为看官方文档我的理解是指令回调url对应POST请求接口，但是在这里申请验证时候接收到的请求参数和数据回调url是一样的，包括请求方式，返回值）

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 5][]

## 三.安装测试 ##

点击安装测试->添加测试企业

这里会提示必须响应并处理“ 授权成功的通知”的回调消息

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 6][]

## 四．设置授权 ##

①官方文档[https://work.weixin.qq.com/api/doc/90001/90143/90600][https_work.weixin.qq.com_api_doc_90001_90143_90600]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 7][]

*  代码实现

整体逻辑如下:

**1.接收回调接口推送suite\_ticket并进行存储及更新（每十分钟推送一次）**

此次调用的接口还是/wx/callback，请求方式为POST，请求包体xml参数需要从body中获取，再解析xml可以判断是推送suite\_ticket事件，再获取SuiteTicket标签中的值，解析成功必须返回success字符串，其他均为失败。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 8][]

**2.调用获取第三方应用凭证接口**

通过http请求调用，suite\_id,suite\_secret在应用管理->应用详情获取

调用成功返回suite\_access\_token，这个值需要进行缓存更新

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 9][]

**3.调用预授权码接口**

成功返回预授权码

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 10][]

**4.调用设置授权配置接口**

获取结果，成功必须返回success字符串，其他均为失败。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 11][]

# 五．扫码安装 #

可以设置哪些人可以使用，点击同意就会调用上述请求。然后在工作台就能打开该应用，会跳转至之前配置的首页。

注：出现cropid校验失败时，要把生成加解密实例的入参cropid换成suitid

![20200325181041659.png][]

最后上架到第三方应用时需要一些条件的；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 12][]

[https_open.work.weixin.qq.com_wwopen_developer_sass_apps_list]: https://open.work.weixin.qq.com/wwopen/developer#/sass/apps/list
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70]: /images/20230528/a12cdf87a1ba4327a970272a92d15a81.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 1]: /images/20230528/0544ad45b32e4278be29c19010629a6a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 2]: /images/20230528/c727e63f826943d2af5963cf2615b9eb.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 3]: /images/20230528/9296be75ffb24adabb9821b2dcaacc95.png
[https_work.weixin.qq.com_api_doc_90001_90143_91116]: https://work.weixin.qq.com/api/doc/90001/90143/91116
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 4]: /images/20230528/efc15e6daec540169c51a53e55b87f20.png
[20200325180542274.png]: /images/20230528/084114cc6c0c48f6ab15e31db6842e48.png
[20200325180542315.png]: /images/20230528/0c4b1241fda64e72953088e0f0b1207b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 5]: /images/20230528/f554f7e916044164ad87ea665d085ede.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 6]: /images/20230528/ef18db5f76dd40dd8d85f01675cda1ff.png
[https_work.weixin.qq.com_api_doc_90001_90143_90600]: https://work.weixin.qq.com/api/doc/90001/90143/90600
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 7]: /images/20230528/5797abe0aa304d078eac94b2e45463a7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 8]: /images/20230528/d859c6ba26bb4657bf4872966f1b52e7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 9]: /images/20230528/b8ba324a82a94dad8d744a5c1a256a3b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 10]: /images/20230528/e84f7505108942e6b1d1f94fb34e4bf3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 11]: /images/20230528/179c779bcee445949760d713940b9319.png
[20200325181041659.png]: /images/20230528/7c06dea40d6a483f9125f49cc8b5d742.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MjQ1NjQ2Ng_size_16_color_FFFFFF_t_70 12]: /images/20230528/d34b82c334084ff89afd370e6fea7c93.png