企业微信开发：获取 access_token（二）

╰+哭是因爲堅強的太久メ 2022-12-13 04:52 805阅读 0赞

## 前言 ##

>   简单的用白话了解一下企业微信的作用，企业微信是腾讯微信团队为企业打造的专业办公管理工具。大致和钉钉差不多，适用于政府、企业等各类组织的一个产品，可以有效的帮您管理员工。个人感觉企业微信开发要比微信开发更简单一些

## 正文 ##

企业微信开发有三个比较比较重要的东西，也是最经常用到的！！  
    1）corpid：每个企业都拥有唯一的corpid  
    2）agentid：每个应用都有唯一的agentid  
    3）secret：secret是企业应用里面用于保障数据安全的“钥匙”

## 获取 access\_token ##

获取 access\_token 是调用企业微信 API 接口的第一步，相当于创建了一个登录凭证，其它的业务 API 接口，都需要依赖于 access\_token 来鉴权调用者身份。

> **请求方式：** GET（HTTPS）  
> **请求地址：** https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET  
> **参数说明：**

<table> 
 <tbody> 
  <tr> 
   <th>参数</th> 
   <th>必须</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <th>corpid</th> 
   <th>是</th> 
   <th>企业ID，获取方式参考：<a href="https://work.weixin.qq.com/api/doc/90000/90135/90665#corpid" rel="nofollow">术语说明-corpid</a></th> 
  </tr> 
  <tr> 
   <th>corpsecret</th> 
   <th>是</th> 
   <th>应用的凭证密钥，获取方式参考：<a href="https://work.weixin.qq.com/api/doc/90000/90135/90665#secret" rel="nofollow">术语说明-secret</a></th> 
  </tr> 
 </tbody> 
</table>

## 代码片段 ##

根据企业ID和自建应用密钥来获取当前的 access\_token （这个是自定义封装的一个工具类）

/**
     * 公众平台通用接口工具类 (目前仅包含企业微信)
     */
    public class AccessTokenAPI {
    
        // 获取企业微信 access_token    
        private final static String qy_access_token_url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=CORPID&corpsecret=CORPSECRET";
    
        // 获取凭证信息
        public static AccessToken getAccessToken(String CORPID,String CORPSECRET){
            AccessToken accessToken = new AccessToken();
            String requestURL = qy_access_token_url.replace("CORPID", CORPID).replace( "CORPSECRET", CORPSECRET);
            JSONObject jsonObject = HttpRequestUtil.httpRequest(requestURL,EnumMethod.GET.name(), null);
            // 如果请求成功
            if (jsonObject != null) {
                try {
                    System.out.println("获取获取凭证信息："+jsonObject);
                    accessToken.setToken(jsonObject.getString("access_token"));
                    accessToken.setExpiresIn(jsonObject.getInteger("expires_in"));
                } catch (Exception e) {
                    accessToken = null;
                }
            }
            return accessToken;
        }
    
    }

上方代码中的 AccessToken 实体类

import lombok.Data;
    
    /**
     * @Description Access_Token 凭证
     * @Author LinLuoChen
     * @Date  14:55
     **/
    @Data
    public class AccessToken {
        // 获取到的凭证  
        private String token;  
        // 凭证有效时间，单位：秒  
        private int expiresIn;  
    
    }

下面继续执行下面的测试方法  
  这个地方需要注意一下，每个应用有独立的secret，所以每个应用的access\_token应该分开来获取

public static void main(String[] args) { 
        // CORPID 和 SECRET 对应企业ID和应用密钥
        AccessToken accessToken = AccessTokenAPI.getAccessToken(CORPID,SECRET);
        System.out.println("获取tocken为："+accessToken);
    }

## 测试结果 ##

获取成功则返回，以下内容

{
       "errcode":0,
       "errmsg":"",
       "access_token": "accesstoken000001",
       "expires_in": 7200
    }

获取失败则返回，以下内容

{
       "errcode":40001,
       "errmsg":"xxxxxxxx"
    }

## access\_token 获取失败 ##

根据[全局错误码][Link 1]的说明 40001 不合法的 secret 参数，secret 在应用详情/通讯录管理助手可查看，排查 secret 的取值也没有错啊，就郁闷了，最后发现问题：是corpid写错了，把企业id写成了应用id！因为“全局错误码”里没有提到corpid错误了会造成40001错误，所以一直以为是scerent的错。

--------------------

有疑惑的地方欢迎留言讨论！  
  关于 getUserCode 这个方法是你在拼接回调地址的方法  
  例如：localhost:端口号/项目地址/请求路径/getUserCode

[Link 1]: https://work.weixin.qq.com/api/doc/90001/90148/90455#%E7%AC%AC%E4%B8%89%E6%AD%A5%EF%BC%9A%E8%8E%B7%E5%8F%96access_token