微信企业号之获取access_token

迷南。 2022-04-11 07:19 777阅读 0赞

### 一.前言 ###

获取access\_token是调用企业微信API接口的第一步，相当于创建了一个登录凭证，其它的业务API接口，都需要依赖于access\_token来鉴权调用者身份。因此开发者，在使用业务接口前，要明确access\_token的颁发来源，使用正确的access\_token。

### 二.使用流程 ###

请求方式： GET（HTTPS）  
请求地址： [https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRECT][https_qyapi.weixin.qq.com_cgi-bin_gettoken_corpid_ID_corpsecret_SECRECT]  
注：此处标注大写的单词ID和SECRET，为需要替换的变量，根据实际获取值更新。其它接口也采用相同的标注，不再说明。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>corpid</td> 
   <td>是</td> 
   <td>企业ID，获取方式参考：<a rel="nofollow">术语说明-corpid</a></td> 
  </tr> 
  <tr> 
   <td>corpsecret</td> 
   <td>是</td> 
   <td>应用的凭证密钥，获取方式参考：<a rel="nofollow">术语说明-secret</a></td> 
  </tr> 
 </tbody> 
</table>

##### 权限说明： #####

每个应用有独立的secret，所以每个应用的access\_token应该分开来获取

##### 返回结果： #####

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

##### 参数说明： #####

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>errcode</td> 
   <td>出错返回码，为0表示成功，非0表示调用失败</td> 
  </tr> 
  <tr> 
   <td>errmsg</td> 
   <td>返回码提示语</td> 
  </tr> 
  <tr> 
   <td>access_token</td> 
   <td>获取到的凭证，最长为512字节</td> 
  </tr> 
  <tr> 
   <td>expires_in</td> 
   <td>凭证的有效时间（秒）</td> 
  </tr> 
 </tbody> 
</table>

##### 注意事项： #####

开发者需要缓存access\_token，用于后续接口的调用（注意：不能频繁调用gettoken接口，否则会受到频率拦截）。当access\_token失效或过期时，需要重新获取。

access\_token的有效期通过返回的expires\_in来传达，正常情况下为7200秒（2小时），有效期内重复获取返回相同结果，过期后获取会返回新的access\_token。  
由于企业微信每个应用的access\_token是彼此独立的，所以进行缓存时需要区分应用来进行存储。  
access\_token至少保留512字节的存储空间。  
企业微信可能会出于运营需要，提前使access\_token失效，开发者应实现access\_token失效时重新获取的逻辑。

[https_qyapi.weixin.qq.com_cgi-bin_gettoken_corpid_ID_corpsecret_SECRECT]: https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRECT