# 获取授权账号详情

调试工具

接口应在服务器端调用,详细说明参见服务端API

# 接口说明

# 接口英文名

getAuthorizerInfo

# 功能描述

该 API 用于获取授权方的基本信息,包括头像、昵称、账号类型、认证类型、原始ID等信息。使用过程中如遇到问题,可在开放平台服务商专区发帖交流

# 注意事项

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

# 调用方式

# HTTPS 调用


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

# 请求参数

属性 类型 必填 说明
access_token string 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用component_access_token
component_appid string 第三方平台 appid
authorizer_appid string 授权的公众号或者小程序的appid

# 返回参数

属性 类型说明
authorizer_info object 授权账号信息
属性 类型 说明
nick_name string 昵称
head_img string 头像
service_type_info object 公众号/小程序类型
属性 类型 说明
id number 类型id
name string 类型说明
verify_type_info object 公众号/小程序认证类型
属性 类型 说明
id number 类型id
name string 类型说明
user_name string 原始 ID
alias string 公众号所设置的微信号,可能为空
qrcode_url string 二维码图片的 URL
business_info object 用以了解功能的开通状况(0代表未开通,1代表已开通)
属性 类型 说明
open_pay number 是否开通微信支付功能
open_shake number 是否开通微信摇一摇功能
open_scan number 是否开通微信扫商品功能
open_card number 是否开通微信卡券功能
open_store number 是否开通微信门店功能
idc number 废弃参数
principal_name string 主体名称
signature string 小程序帐号介绍
MiniProgramInfo object 小程序配置信息,可根据这个字段判断是否为小程序类型授权
属性 类型 说明
network object 小程序配置的合法域名信息
属性 类型 说明
RequestDomain array<string> request合法域名
WsRequestDomain array<string> socket合法域名
UploadDomain array<string> uploadFile合法域名
DownloadDomain array<string> downloadFile合法域名
UDPDomain array<string> udp合法域名
TCPDomain array<string> tcp合法域名
categories array<object> 小程序配置的类目信息
属性 类型 说明
first string 一级类目
second string 二级类目
visit_status number 废弃参数
register_type number 小程序注册方式
account_status number 帐号状态,该字段小程序也返回
basic_config object 基础配置信息
属性 类型 说明
is_phone_configured boolean 是否已经绑定手机号
is_email_configured boolean 是否已经绑定邮箱,不绑定邮箱帐号的不可登录微信公众平台
channels_info 视频号账号类型;如果该授权账号为视频号则返回该字段
authorization_info object 授权信息
属性 类型 说明
authorizer_appid string 授权的公众号或者小程序 appid
authorizer_refresh_token string 刷新令牌(在授权的公众号具备API权限时,才有此返回值),刷新令牌主要用于第三方平台获取和刷新已授权用户的 authorizer_access_token。一旦丢失,只能让用户重新授权,才能再次拿到新的刷新令牌。用户重新授权后,之前的刷新令牌会失效
func_info array<object> 授权给第三方平台的权限集id列表,权限集id的含义可查看权限集介绍
属性 类型 说明
funcscope_category object 授权给开发者的权限集详情
属性 类型 说明
id number 权限集id
type number 权限集类型
name string 权限集名称
desc string 权限集描述

# 其他说明

# 公众号类型

service_type_info返回的id的枚举值说明

类型 说明
0 订阅号
1 由历史老账号升级后的订阅号
2 服务号

# 公众号认证类型

verify_type_info返回的id的枚举值说明

类型 说明
-1 未认证
0 微信认证
1 新浪微博认证
3 已资质认证通过但还未通过名称认证
4 已资质认证通过、还未通过名称认证,但通过了新浪微博认证

# 账号状态

account_status的枚举值说明

类型 说明
1 正常
14 已注销
16 已封禁
18 已告警
19 已冻结

# 小程序类型

service_type_info返回的id的枚举值说明

类型 说明
0 普通小程序
12 试用小程序
4 小游戏
10 小商店
2或者3 门店小程序

# 小程序注册类型

register_type的枚举值说明

类型 说明
0 普通方式注册
2 通过复用公众号创建小程序api注册
6 通过法人扫脸创建企业小程序api注册
13 通过创建试用小程序api注册
15 通过联盟控制台注册
16 通过创建个人小程序api注册
17 通过创建个人交易小程序api注册
19 通过试用小程序转正api注册
22 通过复用商户号创建企业小程序api注册
23 通过复用商户号转正api注册

# 小程序认证类型

verify_type_info返回的id的枚举值说明

类型 说明
-1 未认证
0 微信认证

# 视频号类型

channels_info 返回的id的枚举值说明

类型 说明
0 普通视频号

# 调用示例

示例说明: 公众号返回示例

# 请求数据示例


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

# 返回数据示例


{
  "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
        }
      }
    ]
  }
} 

示例说明: 小程序返回示例

# 请求数据示例


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

# 返回数据示例


{"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}},
                                    ]}
 } 

# 错误码

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