全局错误码

更新时间：2024-07-22 06:34:04下载pdf

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

系统异常错误码

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

错误码	错误信息	说明	解决方案
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不存在	设备所属产品未定义该功能值。	设备所属产品未定义该功能值，请检查是否拼写错误，或者在开发者平台里查看产品开发。
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	指令不存在	请您按照开发者文档，填充对应的参数。	请检查指令参数是否漏传，或拼写错误。
60009001	此 API 不在权限包范围	此 API 不在关联授权关系支持的权限包内	请您参考权限包文档，请选择合适的 API

业务异常错误码

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

错误码	错误信息	说明	解决方案
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 账号名或密码错误，请重新确认或尝试重置密码。	请修改账号或密码后重试，或重置密码。

上一篇通用 API

下一篇服务端 SDK