Loading...

    一、绑定AI授权

    功能说明

    为一个会议室首次配置 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 授权

    功能说明

    解除指定会议室的直接 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 授权与占用

    功能说明

    查询一个会议室对应的直接 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