Asp.net【企业微信开发】应用授权（七）获取应用授权信息

范范

在应用授权，获取到永久授权码后， 我们都要获取当前的授权企业信息， 以便于保存企业， 故就用到了当前接口， 获取应用授权信息

该接口 用于通过永久授权码换取企业微信的授权信息。 永久code的获取，是通过临时授权码使用get_permanent_code 接口获取到的permanent_code。

---

获取应用授权信息，接口调用如下：

请求方式：POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/service/get_auth_info?suite_access_token=SUITE_ACCESS_TOKEN

请求包体：

[C#] 纯文本查看 复制代码

{
     "auth_corpid": "auth_corpid_value",
     "permanent_code": "code_value"
 }

请求包体参数说明：

参数	是否必须	说明
auth_corpid	是	授权方corpid
permanent_code	是	永久授权码，通过get_permanent_code获取

返回结果：

[C#] 纯文本查看 复制代码

{
    "errcode":0 ,
    "errmsg":"ok" ,
    "dealer_corp_info": 
    {
        "corpid": "xxxx",
        "corp_name": "name"
    },
    "auth_corp_info": 
    {
        "corpid": "xxxx",
        "corp_name": "name",
        "corp_type": "verified",
        "corp_square_logo_url": "yyyyy",
        "corp_user_max": 50,
        "corp_agent_max": 30,
        "corp_full_name":"full_name",
        "verified_end_time":1431775834,
        "subject_type": 1,
        "corp_wxqrcode": "zzzzz",
        "corp_scale": "1-50人",
        "corp_industry": "IT服务",
        "corp_sub_industry": "计算机软件/硬件/信息服务",
        "location":"广东省广州市"
    },
    "auth_info":
    {
        "agent" :
        [
            {
                "agentid":1,
                "name":"NAME",
                "round_logo_url":"xxxxxx",
                "square_logo_url":"yyyyyy",
                "appid":1,
                "auth_mode":1,
                "privilege":
                {
                    "level":1,
                    "allow_party":[1,2,3],
                    "allow_user":["zhansan","lisi"],
                    "allow_tag":[1,2,3],
                    "extra_party":[4,5,6],
                    "extra_user":["wangwu"],
                    "extra_tag":[4,5,6]
                },
                "shared_from":
                {
                    "corpid":"wwyyyyy"
                }
            },
            {
                "agentid":2,
                "name":"NAME2",
                "round_logo_url":"xxxxxx",
                "square_logo_url":"yyyyyy",
                "appid":5,
                "shared_from":
                {
                    "corpid":"wwyyyyy"
                }
            }
        ]
    }
}

返回参数说明：

[XML] 纯文本查看 复制代码

参数                                                                     说明
1. auth_corp_info                                                授权方企业信息
2. auth_corp_info.corpid                                授权方企业微信id
3. auth_corp_info.corp_name                        授权方企业名称
4. auth_corp_info.corp_type                        授权方企业类型，认证号：verified, 注册号：unverified
5. auth_corp_info.corp_square_logo_url        授权方企业方形头像
6. auth_corp_info.corp_user_max                授权方企业用户规模
7. auth_corp_info.corp_full_name                授权方企业的主体名称(仅认证或验证过的企业有)，即企业全称。
8. auth_corp_info.subject_type                        企业类型，1. 企业; 2. 政府以及事业单位; 3. 其他组织, 4.团队号
9. auth_corp_info.verified_end_time        认证到期时间
10. auth_corp_info.corp_wxqrcode                授权企业在微工作台（原企业号）的二维码，可用于关注微工作台，二维码有效期为7天
11. auth_corp_info.corp_scale                        企业规模。当企业未设置该属性时，值为空
12. auth_corp_info.corp_industry                企业所属行业。当企业未设置该属性时，值为空
13. auth_corp_info.corp_sub_industry        企业所属子行业。当企业未设置该属性时，值为空
14. auth_corp_info.location                                企业所在地信息, 为空时表示未知
15. auth_info                                                        授权信息。如果是通讯录应用，且没开启实体应用，是没有该项的。通讯录应用拥有企业通讯录的全部信息读写权限
16. auth_info.agent                                                授权的应用信息，注意是一个数组，但仅旧的多应用套件授权时会返回多个agent，对新的单应用授权，永远只返回一个agent
17. auth_info.agent.agentid                                授权方应用id
18. auth_info.agent.name                                授权方应用名字
19. auth_info.agent.square_logo_url                授权方应用方形头像
20. auth_info.agent.round_logo_url                授权方应用圆形头像
21. auth_info.agent.appid                                旧的多应用套件中的对应应用id，新开发者请忽略
22. auth_info.agent.auth_mode                        授权模式，0为管理员授权；1为成员授权
23. auth_info.agent.privilege                        应用对应的权限
24. auth_info.agent.privilege.allow_party                应用可见范围（部门）
25. auth_info.agent.privilege.allow_tag                        应用可见范围（标签）
26. auth_info.agent.privilege.allow_user                应用可见范围（成员）
27. auth_info.agent.privilege.extra_party                额外通讯录（部门）
28. auth_info.agent.privilege.extra_user                额外通讯录（成员）
29. auth_info.agent.privilege.extra_tag                        额外通讯录（标签）
30. auth_info.agent.privilege.level                                权限等级。
                                         1:通讯录基本信息只读
                                         2:通讯录全部信息只读（已废弃）
                                         3:通讯录全部信息读写
                                         4:单个基本信息只读
                                          5:通讯录全部信息只写（已废弃）
31. auth_info.agent.shared_from                                        共享了应用的互联企业信息，仅当由互联的企业共享应用触发的安装时才返回
32. auth_info.agent.shared_from.corpid                        共享了应用的互联企业信息，仅当由互联的企业共享应用触发的安装时才返回
33. dealer_corp_info                                                        代理服务商企业信息
34. dealer_corp_info.corpid                                                代理服务商企业微信id
35. dealer_corp_info.corp_name                                        代理服务商企业微信名称

注意：该接口在调用失败时才返回errcode。没返回errcode视为调用成功