服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端API
数据与智能专区
基础接口
获取数据与智能专区授权信息
获取数据与智能专区授权信息
最后更新:2024/10/30

第三方服务商应用可通过该接口获取企业数据与智能专区的授权详情。

数据与智能专区的会话数据授权变更,包括授权会话类型变更、授权的人员范围变更、授权的会话时长变更,会回调变更授权通知事件。服务商接收到该事件之后,可以调用本接口获取企业数据专区会话数据授权详情进行授权内容变更比对。

请求方式: POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/chatdata/get_corp_auth_info?access_token=ACCESS_TOKEN

参数说明:

参数是否必须类型说明
access_tokenString调用接口凭证

 

权限说明:
调用接口的应用需要满足如下的权限:

应用类型权限要求
自建应用不支持
代开发应用需具备「数据与智能专区」权限
第三方应用需具备「数据与智能专区」权限

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "auth_edition_list": [
   		{
			"edition": 1,
			"auth_scope": {
				"userid_list": ["xxxx"],
				"department_id_list": [1, 2, 3],
				"tag_id_list": [10, 11]
			},
			"status": 1,
            "begin_time": 1726588800,
            "end_time": 1729180799,
			"msg_duration_days": 90
		},
		{
			"edition": 2,
			"auth_scope": {
				"userid_list": ["xxxx"],
				"department_id_list": [1, 2],
				"tag_id_list": [10]
			},
			"status": 1,
      		"begin_time": 1726588800,
      		"end_time": 1729180799,
			"msg_duration_days": 90
		}]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
auth_edition_list企业授权的会话版本。如果授权了多个会话版本,则返回授权的多个会话版本。
auth_edition_list.edition企业授权的会话版本类型
1-内部会话 2-内外部会话 3-内外部会话及语音通话
auth_edition_list.auth_scope.userid_list企业授权存档的人员列表。注意,实际生效人员(参见获取授权存档的成员列表)取决于服务商购买的人数
auth_edition_list.auth_scope.department_id_list企业授权存档的部门列表。注意,实际生效人员(参见获取授权存档的成员列表)取决于服务商购买的人数
auth_edition_list.auth_scope.tag_id_list企业授权存档的标签列表。注意,实际生效人员(参见获取授权存档的成员列表)取决于服务商购买的人数
auth_edition_list.status会话版本的当前状态
1-试用中 2-试用已到期 3-付费使用中 4-付费已到期
auth_edition_list.begin_time如果版本状态是试用中、试用已到期,即为试用的开始生效时间;如果为付费使用中、付费已到期,则为付费的开始生效时间
auth_edition_list.end_time如果版本状态是试用中、试用已到期,即为试用的结束生效时间;如果为付费使用中、付费已到期,则为付费的结束生效时间
auth_edition_list.msg_duration_days会话授权的时长,单位:天(一年按365天计)
上一篇上传临时文件到专区
下一篇概述
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们