错误码说明

平台为开发者提供了RESTful风格的接口,开发者通过HTTP协议中的返回信息可获知接口是否正确或错误的返回。

说明如下:

HTTP返回信息 说明
HTTP/1.1 200 OK 请求成功,返回正确的数据
HTTP/1.1 400 Bad Request 参数错误
HTTP/1.1 401 Bad Request 认证错误
HTTP/1.1 403 Forbidden 接口权限错误
HTTP/1.1 404 Not Found 访问的资源不存在
HTTP/1.1 503 Service Unavailable 服务器发生异常

根据HTTP返回状态码,返回状态码是2xx,表示请求成功。但业务验证错误时都返回如下格式的数据:

{
    "returnCode": 错误码,
    "errorString": "错误信息"
}

返回错误码说明:

code 错误码信息说明
0 执行成功。
10 元数据字段名称含有非法字符。
11 您没有操作权限。
12 访问令牌过期,请重新登录或申请令牌。
13 访问令牌格式错误。
14 无访问令牌。
15 用户名或密码错误。
100 用户名格式错误,应为邮箱格式且域名必须与租户名一致。
101 密码不能为空。
102 用户名已经被使用。
103 用户需要的字段缺失。
104 无效或空用户ID。
105 密码强度不够,需[字母]、[数字]、[特殊字符及空白符]最少其中两种组合,且长度在6到12位之间。
106 用户名应以英文字符开头,以英文字符或数字结尾,可包含_-.,长度为2-16位。
107 租户名不合法。
108 用户名必须邮箱格式,域名必须与租户名一致。
109 租户名不能修改。
110 用户名不能修改。
111 全名为2-32个字符长度,且不能包含特殊字符。
120 权限不存在。
130 您没有操作的权限。
140 不能删除当前登录的用户。
141 不能锁定当前登陆用户。
142 不能锁定当前租户。
143 不能将当前登录的管理员用户降级为普通用户。
144 不能将当前登录的普通用户升级为管理员。
200 被锁定的租户。
201 已经被使用的租户名。
150 您正在试图访问其他租户的数据。
300 未找到租户。
301 非测试租户数据不能清除。
401 未授权。
500 所提供的设备名称已经被使用。
501 设备用户ID未找到。
502 设备未找到。
503 设备模型未找到。
504 项目未找到。
505 项目名称已存在。
506 该项目含有设备,不能删除。
507 有设备引用该设备模型,不能删除。
523 设备事件没有找到ID。
601 模型名称已存在。
602 设备无法更新。
603 有设备引用,模型无法更新。
604 属性定义未找到。
605 属性类型错误。
606 属性无法更新。
607 至少提供一个属性或操作定义。
608 属性类型为只读,不允许下发。
609 该版本模型SDK已存在。
610 生成模型SDK失败。
611 属性列表最多允许128项。
612 操作列表最多允许32项。
701 无效邀请码。
801 设备不在线无法发送控制命令。
1000 删除失败。
1010 未提供所有要求的数据。
1011 %s为1-16个字符长度,且不能包含特殊字符。
1012 %s为2-16个字符长度,且不能包含特殊字符。
1013 %s为%d-%d个字符长度。
1014 以小写字母开头,可以含有字母和数字,长度1到16位之内。
1020 请求参数错误。
1021 不支持的参数请求。
2201 Stream名称已存在。
2202 Stream未找到。
2301 查询规则名称已存在。
2302 查询规则未找到。
2401 Action名称已存在。
2402 Action未找到。
2501 动作关联名称已存在。
2502 动作关联未找到。
2503 动作关联已存在。
2601 系统配置项已存在。
2602 系统配置项未找到。
2702 事件日志未找到。
2801 查询规则格式错误。
9000 网络错误。
9001 发送事件通知失败。
9999 未知的错误。