第三方应用开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
第三方应用开发
服务端API
收银台
应用版本付费
获取企业授权信息
获取企业授权信息
最后更新:2020/12/15

该API用于通过永久授权码换取企业微信的授权信息。

注:接口与 应用授权 - 接口调用 - 获取企业授权信息 为同一接口。不同点是,若应用接入付费策略,则会额外返回字段,这里仅对额外返回的字段进行说明。

请求方式: 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" ,
	..., // 接口返回的其它字段信息说明,可到目录文档 “应用授权 - 接口调用 - 获取企业授权信息” 查看
	"edition_info":
	{
		"agent":
		[
			{
				"agentid":1,
				"edition_id": "RLS65535",
				"edition_name": "协同版",
				"app_status" : 3,
				"user_limit": 200,
				"expired_time": 1541990791,
				"is_virtual_version" : false,
				"is_shared_from_other_corp" : true
			}
		]
	}
}

参数说明:

参数说明
edition_info企业当前生效的版本信息
agent授权的应用信息,注意是一个数组,但仅旧的多应用套件授权时会返回多个agent,对新的单应用授权,永远只返回一个agent
edition_id版本id,可在服务商平台查看已配置的付费版本信息
edition_name版本名称
app_status付费状态。
0-没有付费;
1-限时试用;
2-试用过期;
3-购买期内;
4-购买过期;
5-不限时试用;
6-购买期内,但是人数超标, 注意,超标后还可以用7天;
7-购买期内,但是人数超标, 且已经超标试用7天
user_limit用户上限。
特别注意, 以下情况该字段无意义,可以忽略:
1. 固定总价购买
2. app_status = 限时试用/试用过期/不限时试用
3. 在第2条“app_status=不限时试用”的情况下,如果该应用的配置为“小企业无使用限制”,user_limit有效,且为限制的人数
expired_time版本到期时间(根据购买版本,可能是试用到期时间或付费使用到期时间)。
特别注意,以下情况该字段无意义,可以忽略:
1. app_status = 不限时试用
is_virtual_version是否虚拟版本
is_shared_from_other_corp是否由互联企业分享安装。详见企业互联
上一篇获取企业永久授权码
下一篇延长试用期
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们