【微信公众号】微信公众平台开发 ACCESS TOKEN

淩亂°似流年 2022-06-02 01:45 365阅读 0赞

本文介绍微信公众平台下Access Token的概念及获取方法。

## 一、Access Token ##

access\_token是公众号的全局唯一票据，公众号调用各接口时都需使用access\_token。正常情况下access\_token有效期为7200秒，重复获取将导致上次获取的access\_token失效。

公众号可以使用AppID和AppSecret调用本接口来获取access\_token。AppID和AppSecret可在开发模式中获得（需要已经成为开发者，且帐号没有异常状态）。注意调用所有微信接口时均需使用https协议。

接口调用请求说明

http请求方式: GET
    https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

参数说明

<table style="width:640px;"> 
 <tbody> 
  <tr> 
   <th>参数</th> 
   <th>是否必须</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">grant_type</td> 
   <td style="border-color:#C0C0C0;">是</td> 
   <td style="border-color:#C0C0C0;">获取access_token填写client_credential</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">appid</td> 
   <td style="border-color:#C0C0C0;">是</td> 
   <td style="border-color:#C0C0C0;">第三方用户唯一凭证</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">secret</td> 
   <td style="border-color:#C0C0C0;">是</td> 
   <td style="border-color:#C0C0C0;">第三方用户唯一凭证密钥，既appsecret</td> 
  </tr> 
 </tbody> 
</table>

返回说明

正常情况下，微信会返回下述JSON数据包给公众号：

{"access_token":"ACCESS_TOKEN","expires_in":7200}

<table style="width:640px;"> 
 <tbody> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">access_token</td> 
   <td style="border-color:#C0C0C0;">获取到的凭证</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">expires_in</td> 
   <td style="border-color:#C0C0C0;">凭证有效时间，单位：秒</td> 
  </tr> 
 </tbody> 
</table>

错误时微信会返回错误码等信息，JSON数据包示例如下（该示例为AppID无效错误）:

{"errcode":40013,"errmsg":"invalid appid"}

# 二、AppId和AppSecret #

在微信后台使用找到高级功能-开发模式

![021949547981700.jpg][]

成为开发者之后，就可以看到appid和appsecert了

![021950235484149.jpg][]

如果没有url和Token , 你可以先用方倍工作室的下面的测试通过

URL: 　　http://discuz.comli.com/test.php  
Token: 　weixin

# 三、获取Access Token #

程序实现如下

![复制代码][copycode.gif]

$appid = "";
    $appsecret = "";
    $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$appid&secret=$appsecret";
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); 
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE); 
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    $output = curl_exec($ch);
    curl_close($ch);
    $jsoninfo = json_decode($output, true);
    $access_token = $jsoninfo["access_token"];

![复制代码][copycode.gif]

你也可以直接在浏览器地址栏中，拼接出地址，执行后，获得如下数据

{"access_token":"N2L7KXa084WvelONYjkJ_traBMCCvy_UKmpUUzlrQ0EA2yNp3Iz6eSUrRG0bhaR_viswd50vDuPkY5nG43d1gbm-olT2KRMxOsVE08RfeD9lvK9lMguNG9kpIkKGZEjIf8Jv2m9fFhf8bnNa-yQH3g","expires_in":7200}

参数说明如下

<table> 
 <tbody> 
  <tr> 
   <td style="border-color:#C0C0C0;"> <p style="margin-left:10px;">参数</p> </td> 
   <td style="border-color:#C0C0C0;"> <p style="margin-left:10px;">说明</p> </td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;"> <p style="margin-left:10px;">access_token</p> </td> 
   <td style="border-color:#C0C0C0;"> <p style="margin-left:10px;">获取到的凭证</p> </td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;"> <p style="margin-left:10px;">expires_in</p> </td> 
   <td style="border-color:#C0C0C0;"> <p style="margin-left:10px;">凭证有效时间，单位：秒</p> </td> 
  </tr> 
 </tbody> 
</table>

或者使用官方的接口调试工具，地址为：

[使用网页调试工具调试自定义菜单接口][Link 1]

![021958490958196.jpg][]

点击检查问题得，得到

![021959502832457.jpg][]

这样也获得了access token

## 附：全局返回码说明 ##

公众号每次调用接口时，可能获得正确或错误的返回码，开发者可以根据返回码信息调试接口，排查错误。

全局返回码说明如下：

<table style="width:640px;"> 
 <tbody> 
  <tr> 
   <th>返回码</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">-1</td> 
   <td style="border-color:#C0C0C0;">系统繁忙</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">0</td> 
   <td style="border-color:#C0C0C0;">请求成功</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40001</td> 
   <td style="border-color:#C0C0C0;">获取access_token时AppSecret错误，或者access_token无效</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40002</td> 
   <td style="border-color:#C0C0C0;">不合法的凭证类型</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40003</td> 
   <td style="border-color:#C0C0C0;">不合法的OpenID</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40004</td> 
   <td style="border-color:#C0C0C0;">不合法的媒体文件类型</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40005</td> 
   <td style="border-color:#C0C0C0;">不合法的文件类型</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40006</td> 
   <td style="border-color:#C0C0C0;">不合法的文件大小</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40007</td> 
   <td style="border-color:#C0C0C0;">不合法的媒体文件id</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40008</td> 
   <td style="border-color:#C0C0C0;">不合法的消息类型</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40009</td> 
   <td style="border-color:#C0C0C0;">不合法的图片文件大小</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40010</td> 
   <td style="border-color:#C0C0C0;">不合法的语音文件大小</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40011</td> 
   <td style="border-color:#C0C0C0;">不合法的视频文件大小</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40012</td> 
   <td style="border-color:#C0C0C0;">不合法的缩略图文件大小</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40013</td> 
   <td style="border-color:#C0C0C0;">不合法的APPID</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40014</td> 
   <td style="border-color:#C0C0C0;">不合法的access_token</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40015</td> 
   <td style="border-color:#C0C0C0;">不合法的菜单类型</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40016</td> 
   <td style="border-color:#C0C0C0;">不合法的按钮个数</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40017</td> 
   <td style="border-color:#C0C0C0;">不合法的按钮个数</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40018</td> 
   <td style="border-color:#C0C0C0;">不合法的按钮名字长度</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40019</td> 
   <td style="border-color:#C0C0C0;">不合法的按钮KEY长度</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40020</td> 
   <td style="border-color:#C0C0C0;">不合法的按钮URL长度</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40021</td> 
   <td style="border-color:#C0C0C0;">不合法的菜单版本号</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40022</td> 
   <td style="border-color:#C0C0C0;">不合法的子菜单级数</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40023</td> 
   <td style="border-color:#C0C0C0;">不合法的子菜单按钮个数</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40024</td> 
   <td style="border-color:#C0C0C0;">不合法的子菜单按钮类型</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40025</td> 
   <td style="border-color:#C0C0C0;">不合法的子菜单按钮名字长度</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40026</td> 
   <td style="border-color:#C0C0C0;">不合法的子菜单按钮KEY长度</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40027</td> 
   <td style="border-color:#C0C0C0;">不合法的子菜单按钮URL长度</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40028</td> 
   <td style="border-color:#C0C0C0;">不合法的自定义菜单使用用户</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40029</td> 
   <td style="border-color:#C0C0C0;">不合法的oauth_code</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40030</td> 
   <td style="border-color:#C0C0C0;">不合法的refresh_token</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40031</td> 
   <td style="border-color:#C0C0C0;">不合法的openid列表</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40032</td> 
   <td style="border-color:#C0C0C0;">不合法的openid列表长度</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40033</td> 
   <td style="border-color:#C0C0C0;">不合法的请求字符，不能包含\uxxxx格式的字符</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40035</td> 
   <td style="border-color:#C0C0C0;">不合法的参数</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40038</td> 
   <td style="border-color:#C0C0C0;">不合法的请求格式</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40039</td> 
   <td style="border-color:#C0C0C0;">不合法的URL长度</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40050</td> 
   <td style="border-color:#C0C0C0;">不合法的分组id</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">40051</td> 
   <td style="border-color:#C0C0C0;">分组名字不合法</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">41001</td> 
   <td style="border-color:#C0C0C0;">缺少access_token参数</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">41002</td> 
   <td style="border-color:#C0C0C0;">缺少appid参数</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">41003</td> 
   <td style="border-color:#C0C0C0;">缺少refresh_token参数</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">41004</td> 
   <td style="border-color:#C0C0C0;">缺少secret参数</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">41005</td> 
   <td style="border-color:#C0C0C0;">缺少多媒体文件数据</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">41006</td> 
   <td style="border-color:#C0C0C0;">缺少media_id参数</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">41007</td> 
   <td style="border-color:#C0C0C0;">缺少子菜单数据</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">41008</td> 
   <td style="border-color:#C0C0C0;">缺少oauth code</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">41009</td> 
   <td style="border-color:#C0C0C0;">缺少openid</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">42001</td> 
   <td style="border-color:#C0C0C0;">access_token超时</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">42002</td> 
   <td style="border-color:#C0C0C0;">refresh_token超时</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">42003</td> 
   <td style="border-color:#C0C0C0;">oauth_code超时</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">43001</td> 
   <td style="border-color:#C0C0C0;">需要GET请求</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">43002</td> 
   <td style="border-color:#C0C0C0;">需要POST请求</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">43003</td> 
   <td style="border-color:#C0C0C0;">需要HTTPS请求</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">43004</td> 
   <td style="border-color:#C0C0C0;">需要接收者关注</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">43005</td> 
   <td style="border-color:#C0C0C0;">需要好友关系</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">44001</td> 
   <td style="border-color:#C0C0C0;">多媒体文件为空</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">44002</td> 
   <td style="border-color:#C0C0C0;">POST的数据包为空</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">44003</td> 
   <td style="border-color:#C0C0C0;">图文消息内容为空</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">44004</td> 
   <td style="border-color:#C0C0C0;">文本消息内容为空</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45001</td> 
   <td style="border-color:#C0C0C0;">多媒体文件大小超过限制</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45002</td> 
   <td style="border-color:#C0C0C0;">消息内容超过限制</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45003</td> 
   <td style="border-color:#C0C0C0;">标题字段超过限制</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45004</td> 
   <td style="border-color:#C0C0C0;">描述字段超过限制</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45005</td> 
   <td style="border-color:#C0C0C0;">链接字段超过限制</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45006</td> 
   <td style="border-color:#C0C0C0;">图片链接字段超过限制</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45007</td> 
   <td style="border-color:#C0C0C0;">语音播放时间超过限制</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45008</td> 
   <td style="border-color:#C0C0C0;">图文消息超过限制</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45009</td> 
   <td style="border-color:#C0C0C0;">接口调用超过限制</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45010</td> 
   <td style="border-color:#C0C0C0;">创建菜单个数超过限制</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45015</td> 
   <td style="border-color:#C0C0C0;">回复时间超过限制</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45016</td> 
   <td style="border-color:#C0C0C0;">系统分组，不允许修改</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45017</td> 
   <td style="border-color:#C0C0C0;">分组名字过长</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">45018</td> 
   <td style="border-color:#C0C0C0;">分组数量超过上限</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">46001</td> 
   <td style="border-color:#C0C0C0;">不存在媒体数据</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">46002</td> 
   <td style="border-color:#C0C0C0;">不存在的菜单版本</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">46003</td> 
   <td style="border-color:#C0C0C0;">不存在的菜单数据</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">46004</td> 
   <td style="border-color:#C0C0C0;">不存在的用户</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">47001</td> 
   <td style="border-color:#C0C0C0;">解析JSON/XML内容错误</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">48001</td> 
   <td style="border-color:#C0C0C0;">api功能未授权</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">50001</td> 
   <td style="border-color:#C0C0C0;">用户未授权该api</td> 
  </tr> 
 </tbody> 
</table>

## 附：接口频率限制说明 ##

公众号调用接口并不是无限制的。为了防止公众号的程序错误而引发微信服务器负载异常，默认情况下，每个公众号调用接口都不能超过一定限制，当超过一定限制时，调用对应接口会收到如下错误返回码：

{"errcode":45009,"errmsg":"api freq out of limit"}

各接口调用频率限制如下：

<table style="width:640px;"> 
 <tbody> 
  <tr> 
   <th>接口</th> 
   <th>每日限额</th> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">获取access_token</td> 
   <td style="border-color:#C0C0C0;">2000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">自定义菜单创建</td> 
   <td style="border-color:#C0C0C0;">1000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">自定义菜单查询</td> 
   <td style="border-color:#C0C0C0;">10000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">自定义菜单删除</td> 
   <td style="border-color:#C0C0C0;">1000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">创建分组</td> 
   <td style="border-color:#C0C0C0;">1000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">获取分组</td> 
   <td style="border-color:#C0C0C0;">1000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">修改分组名</td> 
   <td style="border-color:#C0C0C0;">1000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">移动用户分组</td> 
   <td style="border-color:#C0C0C0;">100000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">上传多媒体文件</td> 
   <td style="border-color:#C0C0C0;">5000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">下载多媒体文件</td> 
   <td style="border-color:#C0C0C0;">10000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">发送客服消息</td> 
   <td style="border-color:#C0C0C0;">500000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">获取带参数的二维码</td> 
   <td style="border-color:#C0C0C0;">10000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">获取关注者列表</td> 
   <td style="border-color:#C0C0C0;">500</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">获取用户基本信息</td> 
   <td style="border-color:#C0C0C0;">5000000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">获取网页授权access_token</td> 
   <td style="border-color:#C0C0C0;">2000000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">刷新网页授权access_token</td> 
   <td style="border-color:#C0C0C0;">2000000</td> 
  </tr> 
  <tr> 
   <td style="border-color:#C0C0C0;">网页授权获取用户信息</td> 
   <td style="border-color:#C0C0C0;">2000000</td> 
  </tr> 
 </tbody> 
</table>

> ## 欢迎关注公众号： ##
> 
> # ![70][] #

[021949547981700.jpg]: /images/20220602/4da20a76a0494d1c8d2435da73328c07.png
[021950235484149.jpg]: /images/20220602/567597382acd4658a2af04615a2586d8.png
[copycode.gif]: /images/20220602/ba96eb98f340490e8aa31383f068ff94.png
[Link 1]: https://mp.weixin.qq.com/debug/cgi-bin/apiinfo?t=index&type=%E5%9F%BA%E7%A1%80%E6%94%AF%E6%8C%81&form=%E8%8E%B7%E5%8F%96access_token%E6%8E%A5%E5%8F%A3%20/token
[021958490958196.jpg]: /images/20220602/04b7988239914a9a84ada215c271e003.png
[021959502832457.jpg]: /images/20220602/b65ad1b33baa462988fb64e6c2d4f204.png
[70]: /images/20220602/a1daffc7f688419b9399b889cb61dee3.png