接口描述
描述:拥有用户管理权限的用户可以为企业下账号设置 AI 账号能力。
鉴权方式:JWT 鉴权
自建应用权限点:企业用户管理
请求方式: POST
接口请求域名:
https://api.meeting.qq.com/v1/users/account/ai-account
输入参数
参数名称 | 参数类型 | 是否必须 | 参数描述 |
operator_id | String | 是 | 操作者 ID。 operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 操作者需要拥有企管用户管理权限。 |
operator_id_type | Integer | 是 | 操作者 ID 的类型:
1:userid |
to_operator_id | String | 是 | 被操作者 ID,仅支持企业版/教育版高级账号被设置,其他类型账号会报错。 |
to_operator_id_type | Integer | 是 | 被操作者 ID 类型: 1:userid |
ai_account_type | Integer | 否 | AI 账号类型。 1:购买版 2:赠送版 如果未传入该字段,按拥有的赠送版,购买版顺序分配。 |
输出参数
无输出参数,成功返回空消息体,失败返回错误码和错误信息。
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 500111 | 该账号已经是赠送版 AI 账号。 |
400 | 500112 | 该账号已经是购买版的 AI 账号。 |
400 | 500058 | 该账号已经拥有 AI 账号相关能力。 |
400 | 500059 | 该账号无 AI 账号能力。 |
400 | 500035 | 您已触发上限,请明日再试。 |
400 | 500052 | 该账号不支持操作 AI 账号能力。 |
400 | 500053 | 用户信息查询失败。 |
400 | 500055 | 参数非法,请对照接口文档检查您的参数。 |
400 | 500054 | AI 账号处理失败,该操作者没有权限。 |
400 | 500057 | 资源查询异常。 |
400 | 500028 | 账号资源不足。 |
400 | 500026 | 暂未购买该类账号。 |
400 | 500056 | AI 账号资源不足。 |
400 | 500032 | 内部服务处理失败,请稍后重试。 |
400 | 190004 | 参数非法,请对照接口检查您的参数。 |
示例
输入示例
POST https://api.meeting.qq.com/v1/users/ai-account{"operator_id":"user1","operator_id_type":1,"to_operator_id":"user2","to_operator_id_type":1,"ai_account_type":1}
输出示例
{}