4. 使用授权码换取公众号或小程序的接口调用凭据和授权信息
=======================================================

该 API 用于使用授权码换取授权公众号或小程序的授权信息，并换取
authorizer_access_token 和 authorizer_refresh_token。
授权码的获取，需要在用户在第三方平台授权页中完成授权流程后，在回调 URI
中通过 URL
参数提供给第三方平台方。请注意，由于现在公众号或小程序可以自定义选择部分权限授权给第三方平台，因此第三方平台开发者需要通过该接口来获取公众号或小程序具体授权了哪些权限，而不是简单地认为自己声明的权限就是公众号或小程序授权的权限。

请求格式

``POST``
**https**://api.weixin.qq.com/cgi-bin/component/api_query_auth?component_access_token=xxxx

请求数据

.. code:: json

   {
     "component_appid": "appid_value",
     "authorization_code": "auth_code_value"
   }

请求参数说明

================== ====================================================================
参数               说明
================== ====================================================================
component_appid    第三方平台 appid
authorization_code 授权 code,会在授权成功时返回给第三方平台，详见第三方平台授权流程说明
================== ====================================================================

返回结果

.. code:: json

   {
     "authorization_info": {
       "authorizer_appid": "wxf8b4f85f3a794e77",
       "authorizer_access_token": "QXjUqNqfYVH0yBE1iI_7vuN_9gQbpjfK7hYwJ3P7xOa88a89-Aga5x1NMYJyB8G2yKt1KCl0nPC3W9GJzw0Zzq_dBxc8pxIGUNi_bFes0qM",
       "expires_in": 7200,
       "authorizer_refresh_token": "dTo-YCXPL4llX-u1W1pPpnp8Hgm4wpJtlR6iV0doKdY",
       "func_info": [
         {
           "funcscope_category": {
             "id": 1
           }
         },
         {
           "funcscope_category": {
             "id": 2
           }
         },
         {
           "funcscope_category": {
             "id": 3
           }
         }
       ]
     }
   }

参数说明

+------+---------------------------------------------------------------+
| 参数 | 说明                                                          |
+======+===============================================================+
| auth | 授权信息                                                      |
| oriz |                                                               |
| atio |                                                               |
| n_in |                                                               |
| fo   |                                                               |
+------+---------------------------------------------------------------+
| auth | 授权方 appid                                                  |
| oriz |                                                               |
| er_a |                                                               |
| ppid |                                                               |
+------+---------------------------------------------------------------+
| auth | 授权方接口调用凭据（在授权的公众号或小程序具备 API            |
| oriz | 权限时，才有此返回值），也简称为令牌                          |
| er_a |                                                               |
| cces |                                                               |
| s_to |                                                               |
| ken  |                                                               |
+------+---------------------------------------------------------------+
| expi | 有效期（在授权的公众号或小程序具备 API 权限时，才有此返回值） |
| res_ |                                                               |
| in   |                                                               |
+------+---------------------------------------------------------------+
| auth | 接口调用凭据刷新令牌（在授权的公众号具备 API                  |
| oriz | 权限时，才有此返回值），刷新令牌主要用于第三方平台获取和刷新已授权用户的 |
| er_r |                                                               |
| efre | access_token，只会在授权时刻提供，请妥善保存。                |
| sh_t | 一旦丢失，只能让用户重新授权，才能再次拿到新的刷新令牌        |
| oken |                                                               |
+------+---------------------------------------------------------------+
| func | 授权给开发者的权限集列表，ID 为 1 到 26 分别代表：            |
| _inf |                                                               |
| o    |                                                               |
+------+---------------------------------------------------------------+
|      | 1、消息管理权限                                               |
+------+---------------------------------------------------------------+
|      | 2、用户管理权限                                               |
+------+---------------------------------------------------------------+
|      | 3、帐号服务权限                                               |
+------+---------------------------------------------------------------+
|      | 4、网页服务权限                                               |
+------+---------------------------------------------------------------+
|      | 5、微信小店权限                                               |
+------+---------------------------------------------------------------+
|      | 6、微信多客服权限                                             |
+------+---------------------------------------------------------------+
|      | 7、群发与通知权限                                             |
+------+---------------------------------------------------------------+
|      | 8、微信卡券权限                                               |
+------+---------------------------------------------------------------+
|      | 9、微信扫一扫权限                                             |
+------+---------------------------------------------------------------+
|      | 10、微信连 WIFI 权限                                          |
+------+---------------------------------------------------------------+
|      | 11、素材管理权限                                              |
+------+---------------------------------------------------------------+
|      | 12、微信摇周边权限                                            |
+------+---------------------------------------------------------------+
|      | 13、微信门店权限                                              |
+------+---------------------------------------------------------------+
|      | 14、微信支付权限                                              |
+------+---------------------------------------------------------------+
|      | 15、自定义菜单权限                                            |
+------+---------------------------------------------------------------+
|      | 16、获取认证状态及信息                                        |
+------+---------------------------------------------------------------+
|      | 17、帐号管理权限（小程序）                                    |
+------+---------------------------------------------------------------+
|      | 18、开发管理与数据分析权限（小程序）                          |
+------+---------------------------------------------------------------+
|      | 19、客服消息管理权限（小程序）                                |
+------+---------------------------------------------------------------+
|      | 20、微信登录权限（小程序）                                    |
+------+---------------------------------------------------------------+
|      | 21、数据分析权限（小程序）                                    |
+------+---------------------------------------------------------------+
|      | 22、城市服务接口权限                                          |
+------+---------------------------------------------------------------+
|      | 23、广告管理权限                                              |
+------+---------------------------------------------------------------+
|      | 24、开放平台帐号管理权限                                      |
+------+---------------------------------------------------------------+
|      | 25、 开放平台帐号管理权限（小程序）                           |
+------+---------------------------------------------------------------+
|      | 26、微信电子发票权限 请注意：                                 |
|      | 1）该字段的返回不会考虑公众号是否具备该权限集的权限（因为可能部分具备），请根据公众号的帐号类型和认证情况，来判断公众号的 |
|      | 接口权限。                                                    |
+------+---------------------------------------------------------------+