# 获取授权账号详情

[调试诊断](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_tools)

> 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。

接口英文名：getAuthorizerInfo

该 API 用于获取授权方的基本信息，包括头像、昵称、账号类型、认证类型、原始ID等信息。使用过程中如遇到问题，可在[开放平台服务商专区](https://developers.weixin.qq.com/community/minihome/mixflow/1355698687267438595)发帖交流

## 1. 调用方式

### HTTPS 调用

```bash
POST https://api.weixin.qq.com/cgi-bin/component/api_get_authorizer_info?access_token=ACCESS_TOKEN
```

### 云调用

- 本接口不支持云调用。

### 第三方调用

- 本接口仅支持第三方平台使用 [component_access_token](/doc/oplatform/developers/dev/ComponentAccessToken.md) 自己调用。

## 2. 请求参数

### 查询参数 `Query String Parameters`

```json
[
  {
    "参数名": "access_token",
    "类型": "string",
    "必填": "是",
    "说明": "接口调用凭证，可使用 [component_access_token](/doc/oplatform/openApi/ticket-token/api_getcomponentaccesstoken)"
  }
]
```

### 请求体 `Request Payload`

```json
[
  {
    "参数名": "component_appid",
    "类型": "string",
    "必填": "是",
    "说明": "第三方平台 appid"
  },
  {
    "参数名": "authorizer_appid",
    "类型": "string",
    "必填": "是",
    "说明": "授权的公众号或者小程序的appid"
  }
]
```

## 3. 返回参数

### 返回体 `Response Payload`

```json
[
  {
    "参数名": "authorizer_info",
    "类型": "object",
    "说明": "授权账号信息"
  },
  {
    "参数名": "authorization_info",
    "类型": "object",
    "说明": "授权信息"
  }
]
```

### Res.authorizer_info `Object Payload`

授权账号信息

```json
[
  {
    "参数名": "nick_name",
    "类型": "string",
    "说明": "昵称",
    "枚举": "-"
  },
  {
    "参数名": "head_img",
    "类型": "string",
    "说明": "头像",
    "枚举": "-"
  },
  {
    "参数名": "service_type_info",
    "类型": "object",
    "说明": "公众号/小程序类型",
    "枚举": "-"
  },
  {
    "参数名": "verify_type_info",
    "类型": "object",
    "说明": "公众号/小程序认证类型",
    "枚举": "-"
  },
  {
    "参数名": "user_name",
    "类型": "string",
    "说明": "原始 ID",
    "枚举": "-"
  },
  {
    "参数名": "alias",
    "类型": "string",
    "说明": "公众号所设置的微信号，可能为空",
    "枚举": "-"
  },
  {
    "参数名": "qrcode_url",
    "类型": "string",
    "说明": "二维码图片的 URL",
    "枚举": "-"
  },
  {
    "参数名": "business_info",
    "类型": "object",
    "说明": "用以了解功能的开通状况（0代表未开通，1代表已开通）",
    "枚举": "-"
  },
  {
    "参数名": "idc",
    "类型": "number",
    "说明": "废弃参数",
    "枚举": "-"
  },
  {
    "参数名": "principal_name",
    "类型": "string",
    "说明": "主体名称",
    "枚举": "-"
  },
  {
    "参数名": "signature",
    "类型": "string",
    "说明": "小程序账号介绍",
    "枚举": "-"
  },
  {
    "参数名": "MiniProgramInfo",
    "类型": "object",
    "说明": "小程序配置信息，可根据这个字段判断是否为小程序类型授权",
    "枚举": "-"
  },
  {
    "参数名": "register_type",
    "类型": "number",
    "说明": "小程序注册方式",
    "枚举": "枚举值"
  },
  {
    "参数名": "account_status",
    "类型": "number",
    "说明": "账号状态，该字段小程序也返回",
    "枚举": "枚举值"
  },
  {
    "参数名": "basic_config",
    "类型": "object",
    "说明": "基础配置信息",
    "枚举": "-"
  },
  {
    "参数名": "channels_info",
    "类型": "object",
    "说明": "视频号账号类型；如果该授权账号为视频号则返回该字段",
    "枚举": "-"
  },
  {
    "参数名": "store_info",
    "类型": "object",
    "说明": "小店账号类型；如果该授权账号为小店则返回该字段",
    "枚举": "-"
  },
  {
    "参数名": "talent_info",
    "类型": "object",
    "说明": "带货助手账号类型；如果该授权账号为带货助手则返回该字段",
    "枚举": "-"
  },
  {
    "参数名": "supplier_info",
    "类型": "object",
    "说明": "供货商账号类型；如果该授权账号为供货商则返回该字段",
    "枚举": "-"
  }
]
```

### Res.authorization_info `Object Payload`

授权信息

```json
[
  {
    "参数名": "authorizer_appid",
    "类型": "string",
    "说明": "授权的公众号或者小程序 appid"
  },
  {
    "参数名": "authorizer_refresh_token",
    "类型": "string",
    "说明": "刷新令牌（在授权的公众号具备API权限时，才有此返回值），刷新令牌主要用于第三方平台获取和刷新已授权用户的 authorizer_access_token。一旦丢失，只能让用户重新授权，才能再次拿到新的刷新令牌。用户重新授权后，之前的刷新令牌会失效"
  },
  {
    "参数名": "func_info",
    "类型": "objarray",
    "说明": "授权给第三方平台的权限集id列表，权限集id的含义可查看[权限集介绍](/doc/oplatform/Third-party_Platforms/2.0/product/third_party_authority_instructions.md)"
  }
]
```

### Res.authorizer_info.service_type_info `Object Payload`

公众号/小程序类型

```json
[
  {
    "参数名": "id",
    "类型": "number",
    "说明": "类型id",
    "枚举": "枚举值"
  },
  {
    "参数名": "name",
    "类型": "string",
    "说明": "类型说明",
    "枚举": "-"
  }
]
```

### Res.authorizer_info.verify_type_info `Object Payload`

公众号/小程序认证类型

```json
[
  {
    "参数名": "id",
    "类型": "number",
    "说明": "类型id",
    "枚举": "枚举值"
  },
  {
    "参数名": "name",
    "类型": "string",
    "说明": "类型说明",
    "枚举": "-"
  }
]
```

### Res.authorizer_info.business_info `Object Payload`

用以了解功能的开通状况（0代表未开通，1代表已开通）

```json
[
  {
    "参数名": "open_pay",
    "类型": "number",
    "说明": "是否开通微信支付功能"
  },
  {
    "参数名": "open_shake",
    "类型": "number",
    "说明": "是否开通微信摇一摇功能"
  },
  {
    "参数名": "open_scan",
    "类型": "number",
    "说明": "是否开通微信扫商品功能"
  },
  {
    "参数名": "open_card",
    "类型": "number",
    "说明": "是否开通微信卡券功能"
  },
  {
    "参数名": "open_store",
    "类型": "number",
    "说明": "是否开通微信门店功能"
  }
]
```

### Res.authorizer_info.MiniProgramInfo `Object Payload`

小程序配置信息，可根据这个字段判断是否为小程序类型授权

```json
[
  {
    "参数名": "network",
    "类型": "object",
    "说明": "小程序配置的合法域名信息"
  },
  {
    "参数名": "categories",
    "类型": "objarray",
    "说明": "小程序配置的类目信息"
  },
  {
    "参数名": "visit_status",
    "类型": "number",
    "说明": "废弃参数"
  }
]
```

### Res.authorizer_info.MiniProgramInfo.network `Object Payload`

小程序配置的合法域名信息

```json
[
  {
    "参数名": "RequestDomain",
    "类型": "array",
    "说明": "request合法域名"
  },
  {
    "参数名": "WsRequestDomain",
    "类型": "array",
    "说明": "socket合法域名"
  },
  {
    "参数名": "UploadDomain",
    "类型": "array",
    "说明": "uploadFile合法域名"
  },
  {
    "参数名": "DownloadDomain",
    "类型": "array",
    "说明": "downloadFile合法域名"
  },
  {
    "参数名": "UDPDomain",
    "类型": "array",
    "说明": "udp合法域名"
  },
  {
    "参数名": "TCPDomain",
    "类型": "array",
    "说明": "tcp合法域名"
  }
]
```

">

### Res.authorizer_info.MiniProgramInfo.categories(Array) `Object Payload`

小程序配置的类目信息

```json
[
  {
    "参数名": "first",
    "类型": "string",
    "说明": "一级类目"
  },
  {
    "参数名": "second",
    "类型": "string",
    "说明": "二级类目"
  }
]
```

### Res.authorizer_info.basic_config `Object Payload`

基础配置信息

```json
[
  {
    "参数名": "is_phone_configured",
    "类型": "boolean",
    "说明": "是否已经绑定手机号"
  },
  {
    "参数名": "is_email_configured",
    "类型": "boolean",
    "说明": "是否已经绑定邮箱，不绑定邮箱账号的不可登录微信公众平台"
  }
]
```

### Res.authorizer_info.channels_info `Object Payload`

视频号账号类型；如果该授权账号为视频号则返回该字段

```json
[
  {
    "参数名": "id",
    "类型": "number",
    "说明": "视频号类型",
    "枚举": "枚举值"
  }
]
```

### Res.authorizer_info.store_info `Object Payload`

小店账号类型；如果该授权账号为小店则返回该字段

```json
[
  {
    "参数名": "id",
    "类型": "number",
    "说明": "小店类型",
    "枚举": "枚举值"
  }
]
```

### Res.authorizer_info.talent_info `Object Payload`

带货助手账号类型；如果该授权账号为带货助手则返回该字段

```json
[
  {
    "参数名": "id",
    "类型": "number",
    "说明": "带货助手类型",
    "枚举": "枚举值"
  }
]
```

### Res.authorizer_info.supplier_info `Object Payload`

供货商账号类型；如果该授权账号为供货商则返回该字段

```json
[
  {
    "参数名": "id",
    "类型": "number",
    "说明": "供货商类型",
    "枚举": "枚举值"
  }
]
```

">

### Res.authorization_info.func_info(Array) `Object Payload`

授权给第三方平台的权限集id列表，权限集id的含义可查看[权限集介绍](/doc/oplatform/Third-party_Platforms/2.0/product/third_party_authority_instructions.md)

```json
[
  {
    "参数名": "funcscope_category",
    "类型": "object",
    "说明": "授权给开发者的权限集详情"
  }
]
```

__funcscope_category">

### Res.authorization_info.func_info(Array).funcscope_category `Object Payload`

授权给开发者的权限集详情

```json
[
  {
    "参数名": "id",
    "类型": "number",
    "说明": "权限集id"
  }
]
```

## 4. 枚举信息

### Res.authorizer_info.register_type `Enum`

小程序注册方式

```json
[
  {
    "枚举值": "0",
    "描述": "普通方式注册"
  },
  {
    "枚举值": "2",
    "描述": "通过复用公众号创建小程序api注册"
  },
  {
    "枚举值": "6",
    "描述": "通过法人扫脸创建企业小程序api注册"
  },
  {
    "枚举值": "13",
    "描述": "通过创建试用小程序api注册"
  },
  {
    "枚举值": "15",
    "描述": "通过联盟控制台注册"
  },
  {
    "枚举值": "16",
    "描述": "通过创建个人小程序api注册"
  },
  {
    "枚举值": "17",
    "描述": "通过创建个人交易小程序api注册"
  },
  {
    "枚举值": "19",
    "描述": "通过试用小程序转正api注册"
  },
  {
    "枚举值": "22",
    "描述": "通过复用商户号创建企业小程序api注册"
  },
  {
    "枚举值": "23",
    "描述": "通过复用商户号转正api注册"
  }
]
```

### Res.authorizer_info.account_status `Enum`

账号状态，该字段小程序也返回

```json
[
  {
    "枚举值": "1",
    "描述": "正常"
  },
  {
    "枚举值": "14",
    "描述": "已注销"
  },
  {
    "枚举值": "16",
    "描述": "已封禁"
  },
  {
    "枚举值": "18",
    "描述": "已告警"
  },
  {
    "枚举值": "19",
    "描述": "已冻结"
  }
]
```

### Res.authorizer_info.service_type_info.id `Enum`

类型id

```json
[
  {
    "枚举值": "0",
    "描述": "订阅号"
  },
  {
    "枚举值": "1",
    "描述": "由历史老账号升级后的订阅号"
  },
  {
    "枚举值": "2",
    "描述": "服务号"
  },
  {
    "枚举值": "0",
    "描述": "普通小程序"
  },
  {
    "枚举值": "12",
    "描述": "试用小程序"
  },
  {
    "枚举值": "4",
    "描述": "小游戏"
  },
  {
    "枚举值": "10",
    "描述": "小商店"
  },
  {
    "枚举值": "2或者3",
    "描述": "门店小程序"
  }
]
```

### Res.authorizer_info.verify_type_info.id `Enum`

类型id

```json
[
  {
    "枚举值": "-1",
    "描述": "未认证"
  },
  {
    "枚举值": "0",
    "描述": "微信认证"
  },
  {
    "枚举值": "1",
    "描述": "新浪微博认证"
  },
  {
    "枚举值": "3",
    "描述": "已资质认证通过但还未通过名称认证"
  },
  {
    "枚举值": "4",
    "描述": "已资质认证通过、还未通过名称认证，但通过了新浪微博认证"
  }
]
```

### Res.authorizer_info.channels_info.id `Enum`

视频号类型

```json
[
  {
    "枚举值": "0",
    "描述": "普通视频号"
  }
]
```

### Res.authorizer_info.store_info.id `Enum`

小店类型

```json
[
  {
    "枚举值": "0",
    "描述": "普通小店"
  }
]
```

### Res.authorizer_info.talent_info.id `Enum`

带货助手类型

```json
[
  {
    "枚举值": "0",
    "描述": "普通带货助手账号"
  }
]
```

### Res.authorizer_info.supplier_info.id `Enum`

供货商类型

```json
[
  {
    "枚举值": "0",
    "描述": "普通供货商账号"
  }
]
```

## 5. 注意事项

注意： 公众号和小程序以及视频号的接口返回结果不一样。

## 6. 代码示例

### 6.1 公众号返回示例

请求示例

```json
{
  "component_appid": "appid_value",
  "authorizer_appid": "auth_appid_value"
}
```

返回示例

```json
{
  "authorizer_info": {
    "nick_name": "微信SDK Demo Special",
    "head_img": "http://wx.qlogo.cn/mmopen/GPy",
    "service_type_info": {
      "id": 2
    },
    "verify_type_info": {
      "id": 0
    },
    "user_name": "gh_eb5e3a772040",
    "principal_name": "腾讯计算机系统有限公司",
    "business_info": {
      "open_store": 0,
      "open_scan": 0,
      "open_pay": 0,
      "open_card": 0,
      "open_shake": 0
    },
    "alias": "paytest01",
    "qrcode_url": "URL"
  },
  "authorization_info": {
    "authorizer_appid": "wxf8b4f85f3a794e77",
    "func_info": [
      {
        "funcscope_category": {
          "id": 1
        }
      },
      {
        "funcscope_category": {
          "id": 2
        }
      }
    ]
  }
}
```

### 6.2 小程序返回示例

请求示例

```json
{
  "component_appid": "appid_value",
  "authorizer_appid": "auth_appid_value"
}
```

返回示例

```json
{"authorizer_info":
     {"nick_name":"找呀找呀找盲盒",
      "head_img":"http:xxx",
      "service_type_info":{"id":0},
      "verify_type_info":{"id":-1},
      "user_name":"gh_3dacad47dc6b",
      "alias":"",
      "qrcode_url":"http:xxx",
      "business_info":{"open_pay":0,"open_shake":0,"open_scan":0,"open_card":0,"open_store":0},
      "idc":1,"principal_name":"个人","signature":"欢迎小伙伴一起参与盲盒游戏，集齐9款鞋卡，可以兑换大奖！",
      "MiniProgramInfo":{"network":{"RequestDomain":["https:xxx","https:xxxx","https:xxx"],"WsRequestDomain":[],"UploadDomain":[],"DownloadDomain":[],"BizDomain":[],"UDPDomain":[]},
                         "categories":[{"first":"工具","second":"效率"}],"visit_status":0}},
 "authorization_info":{"authorizer_appid":"wxf24d2dfc1a974128",
                       "authorizer_refresh_token":"xxxxxx",
                       "func_info":[{"funcscope_category":{"id":17}},
                                    {"funcscope_category":{"id":18}},
                                    {"funcscope_category":{"id":19}},{"funcscope_category":{"id":25}},
                                    {"funcscope_category":{"id":30}},
                                    {"funcscope_category":{"id":31}},
                                    {"funcscope_category":{"id":36}},{"funcscope_category":{"id":37}},{"funcscope_category":{"id":40}}
                                    ]}
 }
 ```

## 7. 错误码

以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/oplatform/developers/errCode/README.md)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。

```json
[
  {
    "错误码": "-1",
    "错误描述": "system error",
    "解决方案": "系统繁忙，此时请开发者稍候再试"
  },
  {
    "错误码": "0",
    "错误描述": "ok",
    "解决方案": "ok"
  },
  {
    "错误码": "40001",
    "错误描述": "invalid credential  access_token isinvalid or not latest",
    "解决方案": "获取 access_token 时 AppSecret 错误，或者 access_token 无效。请开发者认真比对 AppSecret 的正确性，或查看是否正在为恰当的公众号调用接口"
  },
  {
    "错误码": "40013",
    "错误描述": "invalid appid",
    "解决方案": "不合法的 AppID ，请开发者检查 AppID 的正确性，避免异常字符，注意大小写"
  }
]
```

## 8. 适用范围

本接口支持「第三方平台」账号类型调用。其他账号类型如无特殊说明，均不可调用。

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)接口变更日志（2条）
2026 年 03 月 17 日新增  `store_info` 、 `talent_info` 、 `supplier_info`  字段
2025 年 11 月 25 日`store_info` 、 `talent_info` 、 `supplier_info`  字段新增，其  `id`  字段新增枚举值并描述