接口描述
描述:拥有用户查看权限的用户可以查看企业下各类型账号资源的统计数据。
鉴权方式:JWT 鉴权
自建应用权限点:企业用户查看
请求方式: GET
接口请求域名:
https://api.meeting.qq.com/v1/users/account/statistics
输入参数
参数名称 | 参数类型 | 是否必须 | 参数描述 |
operator_id | String | 是 | 操作者 ID。 operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 操作者需要拥有企管用户查看权限。 |
operator_id_type | Integer | 是 | 操作者 ID 的类型:
1:userid |
输出参数
参数名称 | 参数类型 | 参数描述 |
user_count | Integer | 当前用户数。 |
user_account_details | UserAccountDetails 对象数组 | 账号类型使用对象。 |
ai_account_details | AIAccountDetails 对象数组 | AI 账号类型使用对象(商业版不返回)。 |
UserAccountDetails 对象
参数名称 | 参数类型 | 参数描述 |
user_account_type | Integer | 账号类型:
1:高级账号 (企业版,教育版)
2:免费账号 (企业版,教育版,商业版)
3:免费账号100方 (商业版)
4:高级账号300方(商业版)
5:高级账号500方(商业版)
6:高级账号1000方(商业版)
7:高级账号2000方(商业版)
8:高级账号100方(商业版) |
user_account_count | Integer | 账号数。 |
user_account_used_count | Integer | 已分配账号数。 |
AIAccountDetails 对象
参数名称 | 参数类型 | 参数描述 |
ai_account_type | Integer | AI 账号类型。 1:购买版 2:赠送版 |
ai_account_count | Integer | 账号数。 |
ai_account_used_count | Integer | 已分配账号数。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
400 | 500053 | 用户信息查询失败。 |
400 | 500055 | 参数非法,请对照接口文档检查您的参数。 |
400 | 500054 | AI 账号处理失败,该操作者没有权限。 |
400 | 500057 | 资源查询异常。 |
示例
输入示例
GET https://api.meeting.qq.com/v1/users/account/statistics?operator_id=user1&operator_id_type=1
输出示例
{"user_count":100,"user_account_details":[{"user_account_type":1,"user_account_count":80,"user_account_used_count":50},{"user_account_type":2,"user_account_count":50,"user_account_used_count":50}],"ai_account_details":[{"ai_account_type":1,"ai_account_count":100,"ai_account_used_count":50}]}