第三方应用开发 服务端API 应用授权 接口调用 获取企业授权信息
获取企业授权信息
最后更新:2023/12/12
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取企业授权信息
最后更新:2023/12/12

该API用于通过永久授权码换取企业微信的授权信息。 永久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

请求包体:

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

参数说明:

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

返回结果:

{
    "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_full_name":"full_name",
		"verified_end_time":1431775834,
		"subject_type": 1,
		"corp_wxqrcode": "zzzzz",
		"corp_scale": "1-50人",
		"corp_industry": "IT服务",
		"corp_sub_industry": "计算机软件/硬件/信息服务"
	},
	"auth_info":
	{
		"agent" :
		[
			{
				"agentid":1,
				"name":"NAME",
				"round_logo_url":"xxxxxx",
				"square_logo_url":"yyyyyy",
				"appid":1,
				"auth_mode":1,
				"is_customized_app":false,
				"auth_from_thirdapp":false,
				"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",
					"share_type": 1
				}
			},
			{
				"agentid":2,
				"name":"NAME2",
				"round_logo_url":"xxxxxx",
				"square_logo_url":"yyyyyy",
				"appid":5,
				"shared_from":
				{
					"corpid":"wwyyyyy",
					"share_type": 0
				}
			}
		]
	}
}

参数说明:

参数说明
auth_corp_info授权方企业信息
auth_corp_info.corpid授权方企业微信id
auth_corp_info.corp_name授权方企业名称
auth_corp_info.corp_type授权方企业类型,认证号:verified, 注册号:unverified
auth_corp_info.corp_square_logo_url授权方企业方形头像
auth_corp_info.corp_user_max授权方企业用户规模
auth_corp_info.corp_full_name授权方企业的主体名称(仅认证或验证过的企业有),即企业全称。企业微信将逐步回收该字段,后续实际返回内容为企业名称,即auth_corp_info.corp_name。
auth_corp_info.subject_type企业类型,1. 企业; 2. 政府以及事业单位; 3. 其他组织, 4.团队号
auth_corp_info.verified_end_time认证到期时间
auth_corp_info.corp_wxqrcode授权企业在微信插件(原企业号)的二维码,可用于关注微信插件,二维码有效期为7天
auth_corp_info.corp_scale企业规模。当企业未设置该属性时,值为空
auth_corp_info.corp_industry企业所属行业。当企业未设置该属性时,值为空
auth_corp_info.corp_sub_industry企业所属子行业。当企业未设置该属性时,值为空
auth_info授权信息。如果是通讯录应用,且没开启实体应用,是没有该项的。通讯录应用拥有企业通讯录的全部信息读写权限「第三方会话存档接口」不返回该字段
auth_info.agent授权的应用信息,注意是一个数组,但仅旧的多应用套件授权时会返回多个agent,对新的单应用授权,永远只返回一个agent
auth_info.agent.agentid授权方应用id
auth_info.agent.name授权方应用名字
auth_info.agent.square_logo_url授权方应用方形头像
auth_info.agent.round_logo_url授权方应用圆形头像
auth_info.agent.appid旧的多应用套件中的对应应用id,新开发者请忽略
auth_info.agent.auth_mode授权模式,0为管理员授权;1为成员授权
auth_info.agent.is_customized_app是否为代开发自建应用
auth_info.agent.privilege应用对应的权限
auth_info.agent.privilege.allow_party应用可见范围(部门)
auth_info.agent.privilege.allow_tag应用可见范围(标签)
auth_info.agent.privilege.allow_user应用可见范围(成员)
auth_info.agent.privilege.extra_party额外通讯录(部门)
auth_info.agent.privilege.extra_user额外通讯录(成员)
auth_info.agent.privilege.extra_tag额外通讯录(标签)
auth_info.agent.privilege.level权限等级。
1:通讯录基本信息只读
2:通讯录全部信息只读(已废弃)
3:通讯录全部信息读写
4:单个基本信息只读
5:通讯录全部信息只写(已废弃)
0:为代开发应用,该值无意义,固定为0,代开发应用权限可使用获取应用权限接口获取
auth_info.agent.shared_from共享了应用的企业信息,仅当由企业互联或者上下游共享应用触发的安装时才返回
auth_info.agent.shared_from.corpid共享了应用的企业corpid,仅当企业互联或者上下游共享应用触发的安装时才返回
auth_info.agent.shared_from.share_type共享了途径,0表示企业互联,1表示上下游
dealer_corp_info代理服务商企业信息
dealer_corp_info.corpid代理服务商企业微信id
dealer_corp_info.corp_name代理服务商企业微信名称

 

注意:因历史原因,该接口在调用失败时才返回errcode。没返回errcode视为调用成功

上一篇
获取企业永久授权码
下一篇
获取企业凭证