错误码说明

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