错误返回结果
若 Rest API 调用失败,返回的 HTTP Status Code 不为200时,则响应体为错误信息,包含错误码和详细的错误信息。
服务错误,HTTP Status Code 统一返回500。
API 请求错误,HTTP Status Code 统一返回400。
详细的错误信息可解析返回消息体中的 JSON 串。
示例
HTTP/1.1 500{"error_info": {"error_code": 9003,"message": "MEETING NOT EXIST"}}
REST API 错误码列表
错误码 | 说明 |
4051 | 录制文件已经被删除。 |
9002 | 获取 TinyId 错误或者 meetingId 错误。 |
9003 | 会议不存在。 |
9008 | 创建会议数量超过限制。单日最多创建会议数100个,每分钟最多创建会议数9个。 |
9042 | 无权限操作。 |
9061 | 查询会议过于频繁,超过限频次数。 |
9093 | 会议主题(subject)包含敏感词。 |
9098 | 会议并发数量超过限制。 |
9099 | 无权限进入预定会议。 |
9100 | 无权限预定会议。 |
9101 | 无权限加入会议。 |
9102 | 无权限修改会议。 |
9103 | 暂不支持将 rooms 移入等候室。 |
9104 | 无法停止该设备视频。 |
10000 | 用户管理 API 调用未知错误类型。 |
10001 | 用户管理 API 调用参数错误。 |
10005 | app-version 被禁用。 |
20001 | 用户不存在。 |
20002 | 用户已存在。 |
20003 | 用户不可用。 |
20004 | 不允许删除超级管理员。 |
20006 | 修改的时间段内存在会议室被占用。 |
40000 | 手机号码不合法。 |
41001 | 邮箱地址不合法。 |
41002 | 邮箱已被使用。 |
41003 | 手机号码已存在。 |
50000 | 企业 ID 不合法。 |
50001 | 企业不可用。 |
156009 | 场景:创建用户接口返回“人数超出上限错误”。 用户申请到的免费 secretId 可以创建的账户数量最大值为99,当创建企业用户超出购买的账户数上限后会遇到该错误,返回显示如下错误信息: {"error_info":{"error_code":156009,"message":"人数超出上限"}} 。升级用户数量许可后,再次尝试,不超出购买上限,则错误不会出现。 |
190001 | |
190004 | 请求参数错误。 |
190300 | API 请求头里的时间戳参数 X-TC-Timestamp 取值与服务器当前时间差距超过5分钟,视为非法请求。 |
190301 | 请求重放错误,请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成,不能使用和过去五分钟内相同的 timestamp 和 nonce。 |
190303 | JWT 校验:未认证的 secret 信息,请检查请求头公共参数里字段 AppId 和 X-TC-Key 内容是否正确。字段 SdkId 如未分配不要携带。 OAuth 检验:请检查 OpenId 是否正确或 Access Token 是否正确或已过期。 |
190310 | 每分钟总接口调用次数超过限制。 注意:默认限制为1分钟内会议所有 API 调用不超过300次,账户级接口不超过100次。 |
190311 | 每天总接口调用次数超过限制。 |
190312 | 每天单个接口调用次数超过限制。 |
190315 | 非会议创建者,无权限操作。 |
190316 | 不存在直播的信息。 |
190317 | 无开启直播。 |
190318 | 查询会议详情失败。 |
190319 | 修改直播配置信息失败。 |
190325 | 1. 请检查当前接口是否支持 OAuth 鉴权。 2. 请确认当前用户的 scopes(权限作用域)是否包含当前请求接口的 scope(权限作用域)。 |
200001 | API 请求头缺失必填字段。 |
200002 | API 请求重放判定。 |
200003 | API 调用签名验证错误。 |
200004 | 不支持的 API 请求。 |
200005 | JSON 串解析错误。 |
200006 | API 请求参数出错。 |
204001 | 用户数据已存在或用户数据错误。 |
500077 | 不支持的文件类型或格式。 |
500078 | 请确保文件/文件块的校验和正确。 |
500079 | 实际传输的文件大小和入参大小不一致。 |
500080 | 文件分块存在缺失,请确保所有文件分块上传完成。 |
500081 | 上传了非预期文件分块。 |
500082 | 文件大小超限。 |
500086 | 分块文件大小非法,需按预上传返回的 block_size 填写(最后一块按照实际大小填写)。 |
500087 | 文件后缀缺失。 |
500083 | 该分块已成功上传,请勿重复上传。 |
500085 | 上传分块前请成功调用预上传接口,最多支持6小时内断点续传。 |
500088 | 录制存储空间不足。 |
500084 | 内部服务异常,请稍后重试。 |
500014 | 账号无权限。 |
OAuth2.0 错误码列表
错误码 | 说明 |
0 | 正常。 |
10 | 参数错误,具体字段错误原因,详细见 message 字段。 |
20 | 系统内部错误。 |
1001 | 应用被封禁。 |
1002 | 授权码(auth_code)无效、过期。 |
1003 | 应用密钥(secret)异常。 |
1004 | 用户 ID(open_id)异常。 |
1005 | 访问凭证(access_token)过期。 |
1006 | 续约凭证(refresh_token)过期。 |
999 | 系统内部错误,具体字段错误原因,详细见 message 字段。 |