错误码说明
云智易平台为开发者提供了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 服务端发生异常