为一个会议室首次配置 AI 授权,或将已有直接授权切换为指定模式。
没有直接授权时首次配置;已有直接授权时请求切换模式,相同模式不重复创建授权。
默认接口请求频率限制:20次/秒。
REST URL
POST https://sdk.xylink.com/api/rest/external/{version}/ai/authorization/bind?enterpriseId=XXX&signature=XXX请求参数说明
参数 | 参数类型 | 参数位置 | 是否必须 | 默认值 | 说明 | 初始平台 |
enterpriseId | String | Query | 是 | 无 | 已开通接口调用权限的企业标识;沿用现有企业认证 | 公有云不存在 分区云5.2-20261225 |
meetingRoomNumber | String | Query | 是 | 无 | 会议室 | 公有云不存在 分区云5.2-20261225 |
mode | String | Query | 否 | SHARED | SHARED/DEDICATED;共享/专享 | 公有云不存在 分区云5.2-20261225 |
响应结果示例(HTTP 204,空响应体)
解除指定会议室的直接 AI 授权,适用于共享和专享模式。
完成鉴权和资源访问校验后直接执行解绑。
解除直接授权不附带停止任务或主动释放占用操作;已有任务可能继续运行,占用也可能仍存在。
默认接口请求频率限制:20次/秒。
REST URL
POST https://sdk.xylink.com/api/rest/external/{version}/ai/authorization/unbind?enterpriseId=XXX&signature=XXX请求参数说明
参数 | 参数类型 | 参数位置 | 是否必须 | 默认值 | 说明 | 初始平台 |
enterpriseId | String | Query | 是 | 无 | 已开通接口调用权限的企业标识;沿用现有企业认证 | 公有云不存在 分区云5.2-20261225 |
meetingRoomNumber | String | Query | 是 | 无 | 非空、非纯空白,会议室存在且允许当前企业访问;单会议室,不接受数组 | 公有云不存在 分区云5.2-20261225 |
响应结果示例(HTTP 204,空响应体)
查询一个会议室对应的直接 AI 授权配置及当前占用情况。
默认接口请求频率限制:20次/秒。
REST URL
GET https://sdk.xylink.com/api/rest/external/{version}/ai/authorization?enterpriseId=XXX&signature=XXX
请求参数说明
参数 | 参数类型 | 参数位置 | 是否必须 | 默认值 | 说明 | 初始平台 |
enterpriseId | String | Query | 是 | 无 | 已开通接口调用权限的企业标识;沿用现有企业认证 | 公有云不存在 分区云5.2-20261225 |
meetingRoomNumber | String | Query | 是 | 无 | 非空、非纯空白,会议室存在且允许当前企业访问;单会议室,不接受数组 | 公有云不存在 分区云5.2-20261225 |
响应结果示例(HTTP 200)
共享绑定并占用:
{
"aiMode": "SHARED",
"aiEnabled": true,
"occupied": true,
"occupyId": "<窗口ID>"
}没有直接绑定且没有占用:
{
"aiMode": "NONE",
"aiEnabled": false,
"occupied": false,
"occupyId": null
}已解绑但原任务仍占用:
{
"aiMode": "NONE",
"aiEnabled": false,
"occupied": true,
"occupyId": "<窗口ID>"
}响应参数说明
参数 | 参数类型 | 说明 | 初始平台 |
aiMode | String | SHARED / EXCLUSIVE / NONE;共享/专享/不存在 | 公有云不存在 分区云5.2-20261225 |
aiEnabled | Boolean | true / false;授权是否启用 | 公有云不存在 分区云5.2-20261225 |
occupied | Boolean | true / false;是否存在当前有效占用窗口 | 公有云不存在 分区云5.2-20261225 |
occupyId | String | occupied=true 时非空,否则 null;占用窗口标识,非任务 ID | 公有云不存在 分区云5.2-20261225 |