第三方服务商应用可通过该接口获取企业数据与智能专区的授权详情。
数据与智能专区的会话数据授权变更,包括授权会话类型变更、授权的人员范围变更、授权的会话时长变更,会回调变更授权通知事件。服务商接收到该事件之后,可以调用本接口获取企业数据专区会话数据授权详情进行授权内容变更比对。
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/chatdata/get_corp_auth_info?access_token=ACCESS_TOKEN
参数说明:
参数 | 是否必须 | 类型 | 说明 |
---|---|---|---|
access_token | 是 | String | 调用接口凭证 |
权限说明:
调用接口的应用需要满足如下的权限:
应用类型 | 权限要求 |
---|---|
自建应用 | 不支持 |
代开发应用 | 需具备「数据与智能专区」权限 |
第三方应用 | 需具备「数据与智能专区」权限 |
返回结果:
{
"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天计) |