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

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

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

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

请求包体:

{
	"auth_code": "auth_code_value"
}

参数说明:

参数是否必须说明
auth_code临时授权码,会在授权成功时附加在redirect_uri中跳转回第三方服务商网站,或通过回调推送给服务商。长度为64至512个字节

返回结果:

{
	"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
基础
连接微信
办公
更新日志
联系我们