全局错误码

更新时间:2023-09-28 09:57:01下载pdf

当调用接口发生错误时,会返回自定义错误信息,您可以参考本文了解云开发的全局错误码。如果您需要更多帮助,请 提交工单 联系涂鸦技术支持。

系统异常错误码

系统异常错误码是指以 50010xx11xx 开头的错误码。通常的报错场景为签名问题、参数错传问题、系统超时问题等。

错误码 错误信息 说明 解决方案
500 system error, please contact the admin 业务应用网络不通或者接口超时。 请稍后重试。如果问题一直存在,请提 工单 给技术支持。
1000 data not exist 数据不存在。 请检查输入参数是否有误。
1001 secret invalid secret 无效。 请检查秘钥是否拼写错误,可参考文档查看秘钥 查询项目信息
1002 access_token is null token 为空。 请您查看访问令牌 access_token 是否为空,可参考 请求结构
1003 grant type invalid 授权类型无效。 请输入有效的授权类型,可参考 获取令牌
1004 sign invalid 签名无效。 请您检查是否新版签名,可参考 签名机制
1005 clientId invalid client_id 无效。 请您检查项目 client_id 是否有效,参考文档查看 查询项目信息
1010 token is expired token 过期。 请您检查访问令牌 token 是否已过期,可参考 获取令牌
1011 token invalid token 无效。 请您检查访问令牌 token 是否无效,可参考 获取令牌
1012 token status is invalid token 状态无效。 请您检查访问令牌 token 状态是否无效,可参考 获取令牌
1013 request time is invalid 请求时间戳过期。 请检查请求的时间戳是否已过期,或与当前时间差距过大,可参考 请求结构
1100 param is empty 某些参数为空。 请您参考 API 文档的 请求参数,检查访问的 API 的参数是否漏传或为空。
1101 params range invalid 参数范围无效。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
1102 param is null 参数为空。 请您参考 API 文档的 请求参数,检查访问的 API 的参数是否漏传或为空。
1103 commands issue error 命令无效。 命令下发失败,请检查命令信息或稍后重试。
1104 type is incorrect type 无效。 请检查类型是否错误。
1105 missing the header 错误的消息头。 请检查请求 header 是否漏传或内容错误,可参考 请求头参数
1106 permission deny 权限拒绝。 接口或设备等数据未授权,请您根据 TID 搜索详细的报错信息 API 调用日志,也可以直接检查设备是否有关联。
1107 code invalid 授权 code 无效。 请检查授权编号输入是否正确。
1108 uri path invalid uri 无效。 请您检查输入的 uri 是否正确。
1109 param is illegal, please check it 参数无效。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
1110 concurrent request over limit 请求过时。 请稍后重试。如果问题一直存在,请提 工单 给技术支持。
1111 system is busy, please retry later 系统繁忙。 请稍后重试。如果问题一直存在,请提 工单 给技术支持。
1112 the user is syncing in the background, please try again later 用户同步中,稍后再试。 用户正在后台同步,请稍后再试。
1113 do not repeat the operation in a short time 重复请求。 请您参考 API 文档 请求结构,稍后再进行操作。
1114 your ip don’t have access to this API 当前请求的 client_id 开启了 云授权 IP 白名单 ,并且当前请求 IP 不在白名单列表内。 请您检查是否开启了白名单配置,请参考文档 管理项目 进行管理。
1199 your requests are too frequent 请求过于频繁。 您的请求过于频繁,请稍后再试。
1400 token invalid token 失效。 请您检查访问令牌 token 是否已失效,可参考 获取令牌
2007 IP cross-region 当前请求的 IP 已经跨区,不允许访问。 请访问您的 IP 所在区域的数据中心,数据中心地址,如果一定要跨区访问,请配置 云授权 IP 白名单
28841001 无权限 未订阅云开发企业版。 请先订阅云开发企业版后操作 云服务
28841002 云开发企业版订阅已到期,无权限。 您的云开发企业版订阅已到期。 请续期/重新订阅云开发企业版 云服务
28841003 云开发企业版账单超期未支付,无权限。 存在超期未支付的云开发企业版账单。 请先支付云开发企业版账单后操作 费用
28841004 云开发试用版额度耗尽,无权限。 已超出云开发试用版的额度。 请升级云开发企业版后操作,或等额度刷新后再操作 云服务
28841101 此API未开通,无权限。 您还未开通此 API。 请开通包含该 API 的服务包后操作 云服务
28841102 此API订阅已到期,无权限。 此 API 订阅已到期。 请续期/开通包含该 API 的服务包后操作 云服务
28841103 此API账单超期未支付,无权限。 此 API 存在超期未支付的账单。 请先支付包含该 API 的服务包账单后操作 费用
28841104 此API额度耗尽,无权限。 已超出此 API 的调用额度。 请升级包含该 API 的服务包,或等额度刷新后再操作 云服务
28841105 此API未授权给此项目,无权限。 此 API 未授权给指定的云项目。 请先进行项目授权,或修改项目后操作 云服务
28841106 此API未开通,无权限。 未获得此 API 的定向授权。 请先开通包含该 API 的服务包后操作 云服务

IoT Core 异常错误码

错误码 错误信息 说明 解决方案
40000001 属性为空 属性不能为空。 请检查是否漏传了属性,或者属性为空。
40000002 自定义名称非法 名字是为空,或包含了表情字符。 请检查是否漏传了名字,或者名字为空。
40000003 code不存在 设备所属产品未定义该功能值。 设备所属产品未定义该功能值,请检查是否拼写错误,或者在 IoT 平台里查看 产品开发
40000200 系统异常 请联系管理员。 请稍后重试。如果问题一直存在,请提 工单 给技术支持。
40000203 非法参数 请参考 API 文档设置参数。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40000232 网关下有其他zigbee设备正在升级 请确认后稍后重试。 请稍后重试。如果问题一直存在,请提 工单 给技术支持。
40000233 当前已经是最新版本 当前已经是最新版本。 请比对版本号是否一致,或稍后重试。
40000247 设备模块不存在 请确认设备激活时是否上报了设备模组。 请确认设备激活时是否上报了设备模块。
40000302 远程api调用失败 请联系管理员。 请稍后重试。如果问题一直存在,请提 工单 给技术支持。
40000303 参数错误 请参考 API 文档设置参数。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40000308 命令或值格式有误 请参考 API 文档设置参数。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40000801 设备不在线 请检查设备。 请检查设备连接状态,如网络状况、设备是否通电启动等。
40000802 属性错误 请检查设备属性。 请检查设备属性是否错误。
40000901 设备不存在 请检查传参。 请检查请求参数是否拼写错误。
40000903 参数不合法,请检查参数 请参考 API 文档设置参数。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40000904 列表参数个数太多 请参考 API 文档设置参数。 请按照 API 文档的 请求参数 说明,输入合适数量的列表参数个数。
40000999 设备系统异常 请联系管理员。 请稍后重试。如果问题一直存在,请提 工单 给技术支持。
40001001 空间id为空 请检查输入参数是否正确。 请检查空间 ID 是否漏传,或为空。
40001002 父空间id不合法 请检查参数 parent_space_id 是否正确。 请检查 parent_space_id 是否漏传,或拼写错误。
40001003 空间名称为空 请检查输入参数是否正确。 请检查空间名称是否漏传,或为空。
40001004 空间名称过长 空间名称长度 1-50 字符。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40001005 空间描述过长 空间描述长度 1-255 字符。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40001101 资源 ID 为空 请检查输入参数是否正确。 请检查资源 ID 是否漏传,或为空。
40001102 资源集合长度超出限制 资源集合长度超出限制。 请按照 API 文档的 请求参数 说明,输入合适数量的资源集合。
40001103 资源类型不合法 请检查输入参数是否正确。 请按照 API 文档的 请求参数 说明,输入正确的参数值。
40001104 资源不存在 请检查输入参数是否正确。 请检查参数是否漏传,或拼写错误。
40001105 资源已存在于该空间 请检查输入参数是否正确。 请检查该资源是否已存在。
40001106 当前空间存在子空间 您必须删除子空间才能继续操作。 请先删除子空间。
40001107 当前空间存在未删除资源 请删除资源后再重试。 请先删除空间下的资源。
40001900 无空间权限 无空间权限。 请先进行授权后操作。
40001901 空间不存在 空间不存在。 请检查参数是否漏传,或拼写错误。
40001902 参数不合法 请检查参数后重试。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40002901 群组不存在, 请查询群组是否有效 群组不存在,请查询群组是否有效。 请检查参数是否漏传,或拼写错误。
40002902 群组 uid 不存在,请检查参数是否正确 群组 uid 不存在,请检查参数是否正确。 请检查群组 uid 是否拼写错误。
40002903 空间下群组数量或群组下设备数量超过最大上限,请确认当前空间是否超过上限 空间下群组数量或群组下设备数量超过最大上限,请确认当前空间是否超过上限。 请确认当前空间是否超过上限。
40002904 群组无权限 群组无权限。 请检查当前账号是否拥有群组权限。
40002905 产品不支持创建群组 将产品配置成可创建群组。 请将产品配置成可创建群组。
40002906 参数错误 请检查参数。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40002999 群组服务异常,请联系管理员处理 群组服务异常,请联系管理员处理。 请稍后重试。如果问题一直存在,请提 工单 给技术支持。
40003900 参数为空 请您按照开发者文档,填充对应的参数。 请按照 API 文档的 请求参数,检查参数是否漏传或为空。
40003901 参数非法 请您参照开放者接口,填充合法参数。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40003902 联动场景不支持启用/禁用 检查传入的参数是否包含场景的规则 ID。 请检查输入参数是否包含场景的规则 ID。
40003903 参数应为空 请您按照开发者文档,填充对应的参数。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40003904 联动规则不存在 请检查传参。 请检查请求参数是否漏传,或拼写错误。
40003905 联动规则的条件存在相同的编码 请检查传参。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40004001 参数非法 请您按照开发者文档,填充对应的参数。 请按照 API 文档的 请求参数 说明,输入正确的参数类型和范围。
40004002 指令不存在 请您按照开发者文档,填充对应的参数。 请检查指令参数是否漏传,或拼写错误。

业务异常错误码

业务异常错误码是指以 20x21x 开头的错误码。通常的报错场景为设备离线问题、用户数据问题、任务运行问题等。

错误码 错误信息 说明 解决方案
2001 device is offline 设备已下线。 请您检查设备网络是否正常。
2002 this user doesn’t have any devices 用户没有设备。 请您检查用户账号下是否关联设备。
2003 function not support 不支持的功能。 请按照 API 文档的 请求参数 说明,输入正确的指令进行操作。
2004 not support the lock type 不支持的 lock 类型。 请按照 API 文档的 请求参数 说明,输入正确的 lock 类型进行操作。
2005 product not exist 产品不存在。 请检查产品参数是否漏传,或拼写错误。
2006 user not exist 用户不存在。 请检查用户参数是否漏传,或拼写错误。
2007 device token expired 设备 token 过期。 请检查设备 token 是否过期。
2008 command or value not support 指令不支持。 请按照 API 文档的 请求参数 说明,输入正确的指令进行操作。
2009 not support this device 设备不支持。 请按照 API 文档的 请求参数 说明,输入正确类型的设备进行操作。
2010 device not exist 设备不存在。 请检查设备参数是否漏传,或拼写错误。
2012 application not support 应用不支持。 请按照 API 文档的 请求参数 说明,输入正确类型的应用进行操作。
2013 add timer failed 添加定时任务失败。 请检查参数是否正确,稍后重试,或联系管理员。
2014 this device doesn’t have any timers 设备没有定时任务。 请检查设备是否添加了定时任务。
2015 this category is not supported 品类不支持。 请按照 API 文档的 请求参数 说明,输入正确类型的品类进行操作。
2016 remote control is removed or does not exist 远程控制被移除或者不存在。 请检查远程控制是否存在,或参数是否拼写错误。
2017 schema does not exist app schema 不存在。 请检查 app schema 是否存在,或参数是否拼写错误。
2018 data decrypt failed 数据解密失败。 请检查参数是否输入错误,稍后重试,或联系管理员。
2019 time over two hours 时间超过 2 小时。 请检查时间跨度是否超过最大时间。
2020 Only third-party clouds are supported 仅支持第三方云。 请检查是不是第三方云。
2021 Illegal email email 错误。 请检查电子邮箱格式是否错误。
2022 Illegal phone 手机号错误。 请检查手机号格式是否错误。
2023 user exist 用户已存在。 请检查用户账号是否已经创建。
2024 device file path is not standardized 设备与文件路径无效。 请按照 API 文档的 请求参数 说明,检查设备文件路径是否符合格式要求。
2025 device and file path mismatch 设备与文件路径不匹配。 请检查设备与文件路径是否符合格式要求,是否匹配。
2026 ip failed to get 获取 IP 失败。 请检查是否使用了代理等。
2027 size too large size 过大。 请检查输入的文本或文件是否过大。
2028 encryption token expire token 过期。 请您检查加密令牌 token 是否已过期。
2029 session status is invalid session 无效。 请检查 session 是否拼写错误或已过期。
2030 virtual scan only supports ay region 虚拟扫描仅支持中国区。 请检查接口请求路径是否是中国区。
2031 third-party platform authorization failed 第三方鉴权失败。 请检查第三方服务是否正常,稍后重试,或联系管理员。
2032 app pushed request unique ID is duplicate request_id 重复,需要保证幂等。 请检查 request_id 生成是否正常,或存在重复发送请求。
2033 more than 1000 app message push users 推送用户数量过多。 请按照 API 文档的 请求参数 说明,输入正确的参数。
2037 the username has been bound by another username type 用户已经绑定了其他 type。 请检查用户是否已经绑定了其他 type。
2041 operator name is exist 操作人用户名已经存在。 请检查操作人用户名是否已经存在。
2042 operator not exist 操作人不存在。 请检查操作人是否存在,或操作人参数是否拼写错误。
2043 operator uuid not exist UUID 不存在。 请检查 UUID 是否存在,或 UUID 参数是否拼写错误。
2044 operator ip not exist IP 不存在。 请检查 IP 是否存在,或 IP 参数是否拼写错误。
2045 operator ip has bind 操作人 IP 已经绑定。 请检查 IP 是否已经绑定。
2046 operator uuid has bind 操作人 UUID 已绑定。 请检查 UUID 是否已经绑定。
2047 this device is frozen by user, cannot command 设备已经被冻结。 请检查设备是否已经被冻结。
2050 the infrared code corresponding to the key does not exist 红外代码不存在。 请检查红外代码是否存在,或参数是否拼写错误。
2051 send infrared command failed 发送红外指令失败。 请检查指令是否正确,稍后重试,或联系管理员。
2052 not support the command to set specific temperature 不支持设置特定温度的命令。 请按照 API 文档的 请求参数 说明,输入正确的命令。
2053 the matching infrared code is invalid 匹配的红外代码无效。 请检查红外代码的状态,或红外代码参数是否拼写错误。
2054 the sub-device does not exist 子设备不存在。 请检查子设备是否存在,或参数是否拼写错误。
2055 not support the device 不支持的设备。 请按照 API 文档的 请求参数 说明,输入正确类型的设备。
2056 device has bind or not active 设备已绑定或者未活跃。 请检查设备的状态,或检查参数是否拼写错误。
2060 failed to add user, please try it later 添加用户失败。 请稍后重试,或联系管理员。
2061 message push config are not set 消息推送配置未设置。 请先设置消息推送配置。
2062 data already exists 数据已存在。 请检查数据是否已经存在,请勿重复操作。
2063 other Zigbee device is upgrading 其他 Zigbee 设备正在更新。 请检查其他 Zigbee 设备是否更新中,或稍后重试。
2064 device version is the latest 设备版本是最新的。 请比对设备版本是否一样。
2101 duplicate naming under the device 设备名称重复。 请检查设备名称是否重复。
2401 username or password wrong 用户 App 账号名或密码错误,请重新确认或尝试重置密码。 请修改账号或密码后重试,或重置密码。