错误码说明
云智易平台为开发者提供了RESTful风格的接口,开发者通过HTTP协议中的返回信息可获知接口是否正确或错误的返回。
说明如下:
| HTTP返回信息 | 说明 |
|---|---|
| HTTP/1.1 200 OK | 请求成功,返回正确的数据 |
| HTTP/1.1 400 Bad Request | 参数错误 |
| HTTP/1.1 403 Forbidden | 接口权限错误 |
| HTTP/1.1 404 Not Found | 访问的资源不存在 |
| HTTP/1.1 503 Service Unavailable | 服务器发生异常 |
根据HTTP返回状态码,除了返回状态码是200并返回正确数据的情况下,其他返回状态码都返回如下格式的数据:
{"error":{"code":"错误码","msg":"错误码信息"}}
code的组成格式是{HTTP返回状态码}+{错误编号}
HTTP 返回状态码为400的错误说明:
| code | 错误码信息说明 |
|---|---|
| 4001001 | 请求数据字段验证不通过 |
| 4001002 | 请求数据必须字段不可为空 |
| 4001003 | 手机验证码不存在 |
| 4001004 | 手机验证码错误 |
| 4001005 | 注册的手机号已存在 |
| 4001006 | 注册的邮箱已存在 |
| 4001007 | 密码错误 |
| 4001008 | 帐号不合法 |
| 4001009 | 企业成员状态不合法 |
| 4001010 | 刷新token不合法 |
| 4001011 | 未知成员角色类型 |
| 4001012 | 只有管理员才能邀请 |
| 4001013 | 不可修改其他成员信息 |
| 4001014 | 不能删除本人 |
| 4001015 | 未知的产品连接类型 |
| 4001016 | 已发布的产品不可删除 |
| 4001017 | 固件版本已存在 |
| 4001018 | 数据端点未知数据类型 |
| 4001019 | 数据端点索引已存在 |
| 4001020 | 已发布的数据端点不可删除 |
| 4001021 | 该产品下设备MAC地址已存在 |
| 4001022 | 不能删除已激活的设备 |
| 4001023 | 扩展属性Key为预留字段 |
| 4001024 | 设备扩展属性超过上限 |
| 4001025 | 新增已存在的扩展属性 |
| 4001026 | 更新不存在的扩展属性 |
| 4001027 | 属性字段名不合法 |
| 4001028 | 邮件验证码不存在 |
| 4001029 | 邮件验证码错误 |
| 4001030 | 用户状态不合法 |
| 4001031 | 用户手机尚未认证 |
| 4001032 | 用户邮箱尚未认证 |
| 4001033 | 用户已经订阅设备 |
| 4001034 | 用户没有订阅该设备 |
| 4001035 | 自动升级任务名称已存在 |
| 4001036 | 升级任务状态未知 |
| 4001037 | 已有相同的起始版本升级任务 |
| 4001038 | 设备激活失败 |
| 4001039 | 设备认证失败 |
| 4001041 | 订阅设备认证码错误 |
| 4001042 | 授权名称已存在 |
| 4001043 | 该告警规则名称已存在 |
| 4001045 | 数据表名称已存在 |
| 4001046 | 产品固件文件超过大小限制 |
| 4001047 | APN密钥文件超过大小限制 |
| 4001048 | APP的APN功能未启用 |
| 4001049 | 产品未允许用户注册设备 |
| 4001050 | 该类型的邮件模板已存在 |
| 4001051 | 邮件模板正文内容参数缺失 |
HTTP 返回状态码为403的错误说明:
| code | 错误码信息说明 |
|---|---|
| 4031001 | 禁止访问 |
| 4031002 | 禁止访问,需要Access-Token |
| 4031003 | 无效的Access-Token |
| 4031004 | 需要企业的调用权限 |
| 4031005 | 需要企业管理员权限 |
| 4031006 | 需要数据操作权限 |
| 4031007 | 禁止访问私有数据 |
| 4031008 | 分享已经被取消 |
| 4031009 | 分享已经接受 |
| 4031010 | 用户没有订阅设备,不能执行操作 |
HTTP 返回状态码为404的错误说明:
| code | 错误码信息说明 |
|---|---|
| 4041001 | URL找不到 |
| 4041002 | 企业成员帐号不存在 |
| 4041003 | 企业成员不存在 |
| 4041004 | 激活的成员邮箱不存在 |
| 4041005 | 产品信息不存在 |
| 4041006 | 产品固件不存在 |
| 4041007 | 数据端点不存在 |
| 4041008 | 设备不存在 |
| 4041009 | 设备扩展属性不存在 |
| 4041010 | 企业不存在 |
| 4041011 | 用户不存在 |
| 4041012 | 用户扩展属性不存在 |
| 4041013 | 升级任务不存在 |
| 4041014 | 第三方身份授权不存在 |
| 4041015 | 告警规则不存在 |
| 4041016 | 数据表不存在 |
| 4041017 | 数据不存在 |
| 4041018 | 分享资源不存在 |
| 4041019 | 企业邮箱不存在 |
| 4041020 | APP不存在 |
| 4041021 | 产品转发规则不存在 |
| 4041022 | 邮件模板不存在 |
HTTP 返回状态码为503的错误说明:
| code | 错误码信息说明 |
|---|---|
5031001 服务端发生异常