Global Error Codes - Tuya IoT Development Platform - Tuya IoT Development Platform

You might also like

Download as pdf or txt
Download as pdf or txt
You are on page 1of 13

Global Error Codes

Version: 20230727

Online Version
Contents

Contents

1 System error codes 2

2 IoT Core error codes 4

3 Service error codes 8

I
Contents

If errors occur in API requests, custom error messages will be returned. This topic
describes different error codes and their error messages. You can also submit a
ticket to request technical support.

1 / 11
1 System error codes

1 System error codes

System error codes start with 500, 10xx, and 11xx. System errors might be caused by
signature issues, wrong parameters, and system timeout.

Error code Error message Description

500 system error, please The business application


contact the admin network is unavailable or
the interface times out.
1000 data not exist The data does not exist.
1001 secret invalid The secret is invalid.
1002 access_token is null The token is empty.
1003 grant type invalid The authorization type is
invalid.
1004 sign invalid The signature is invalid.
1005 clientId invalid The value of clientid is
invalid.
1006 not support content type The content type is not
supported.
1007 not support key The key is not supported.
1008 invalid access The value of accessid is
invalid.
1010 token is expired The token has expired.
1011 token invalid The token is invalid.
1012 token status is invalid The token status is
invalid.
1013 request time is invalid The request timestamp
has expired.
1100 param is empty The specified parameters
are empty.
1101 params range invalid The parameter range is
invalid.

2 / 11
1 System error codes

Error code Error message Description

1102 param is null The parameter is empty.


1103 commands issue error The specified command
is invalid.
1104 type is incorrect The type is incorrect.
1105 missing the header The header is missing.
1106 permission deny The permission request is
denied.
1107 code invalid The authorization code is
invalid.
1108 uri path invalid The value of uri is invalid.
1109 param is illegal, please The parameters are
check it invalid.
1110 concurrent request over The request timed out.
limit
1111 system is busy, please The system is busy.
retry later
1112 the user is syncing in the The user is synchronizing
background, please try data in the background.
again later
1113 do not repeat the Do not repeat the
operation in a short time operation in a short time.
1114 your ip(%s) don’t have Your IP address is not
access to this API allowed to request the
current API, or the
current IP address is not
in the allowlist.
1199 your requests are too Your requests are too
frequent frequent.
1400 token invalid The token is invalid.

3 / 11
2 IoT Core error codes

2 IoT Core error codes

Error code Error message Description

40000001 The property is empty. The property cannot be


empty.
40000002 Illegal custom name. The name is empty, or
contains emoticons.
40000003 The code does not exist. The product to which the
device belongs does not
define this feature value.
40000200 System error. Please contact your
administrator.
40000203 Illegal parameter. Refer to the API
documentation to set
parameters.
40000232 Another Zigbee device of Please try again later.
the gateway is being
updated.
40000233 Your system is up to date. Your system is up to date.
40000247 The specified device Check whether the
module does not exist. device module is
reported when the device
is activated.
40000302 Failed to remotely make Please contact your
API calls. administrator.
40000303 Parameter errors. Refer to the API
documentation to set
parameters.
40000308 The format of the Refer to the API
specified command or documentation to set
value is incorrect. parameters.
40000801 The device is offline. Check whether the
device is online.

4 / 11
2 IoT Core error codes

Error code Error message Description

40000802 Property error. Check the device


property.
40000901 The specified device Check the parameters.
does not exist.
40000903 Illegal parameter. Please Refer to the API
check. documentation to set
parameters.
40000904 Too many parameters in Refer to the API
the list. documentation to set
parameters.
40000999 System error. Please contact your
administrator.
40001001 The space ID is empty. Check whether the input
parameter is correct.
40001002 The parent space ID is Check whether the
illegal. parent_space_id parameter
is correct.
40001003 The space name is Check whether the input
empty. parameter is correct.
40001004 The space name is too The space name can
long. contain 1 to 50
characters.
40001005 The space description is The space description
too long. can contain 1 to 255
characters.
40001101 The resource ID is empty. Check whether the input
parameter is correct.
40001102 The resource set The resource set
exceeded the length exceeded the length
limit. limit.
40001103 Illegal resource type. Check whether the input
parameter is correct.

5 / 11
2 IoT Core error codes

Error code Error message Description

40001104 The specified resource Check whether the input


does not exist. parameter is correct.
40001105 The specified resource Check whether the input
already exists in the parameter is correct.
space.
40001106 The current space You must delete the
contains a subspace. subspace to continue.
40001107 The current space has Delete the resources and
resources undeleted. try again later.
40001900 No permission to access No permission to access
the space. the space.
40001901 The specified space does The specified space does
not exist. not exist.
40001902 Illegal parameter. Check the parameter and
try again.
40002901 The group does not exist. The group does not exist.
Check whether the group Check whether the group
is valid. is valid.
40002902 The group UID does not The group UID does not
exist. Check whether the exist. Check whether the
parameters are correct. parameters are correct.
40002903 The number of groups or The number of groups or
devices in the space devices in the space
exceeds the maximum exceeds the maximum
limit. Please check the limit. Please check the
number of groups or number of groups or
devices in the space. devices in the space.
40002904 No permission to access No permission to access
the group. the group.
40002905 The product does not Configure the product to
support creating groups. create groups.
40002906 Parameter errors. Check the parameter.

6 / 11
2 IoT Core error codes

Error code Error message Description

40002999 Group service error. Group service error.


Contact the admin. Contact the admin.
40003900 The {0} parameter is Enter the parameter as
empty. instructed in the
documentation.
40003901 The {0} parameter is Enter the legal
illegal. parameter according to
the developer
documentation.
40003902 The linkage scene cannot Check whether the input
be enabled or disabled. parameter contains the
rule ID of the scene.
40003903 The {0} parameter shall Enter the parameter as
be empty. instructed in the
documentation.
40003904 The linkage rule does not Check the parameters.
exist.
40003905 The conditions of linkage Check the parameters.
rules have the same
code.
40004001 The {0} parameter is Enter the parameter as
illegal. instructed in the
documentation.
40004002 The {0} command does Enter the parameter as
not exist. instructed in the
documentation.

7 / 11
3 Service error codes

3 Service error codes

Service error codes start with 20x and 21x. Service errors might be caused by device
offline issues, users’data issues, and task operation issues.

Error codes Error message Description

2001 device is offline The device gets offline.


2002 this user doesn’t have The user does not have
any devices any devices.
2003 function not support The specified feature is
not supported.
2004 not support the lock type The lock type is not
supported.
2005 product not exist The specified product
does not exist.
2006 user not exist The specified user does
not exist.
2007 device token expired The device token has
expired.
2008 command or value not The command or value is
support not supported.
2009 not support this device This type of device is not
supported.
2010 device not exist The specified device
does not exist.
2012 application not support The application is not
supported.
2013 add timer failed Failed to add a scheduled
task.
2014 this device doesn’t have The device does not have
any timers a scheduled task.
2015 this category is not The category is not
supported supported.

8 / 11
3 Service error codes

Error codes Error message Description

2016 remote control is The remote control is


removed or does not removed or does not
exist exist.
2017 schema does not exist The app schema does
not exist.
2018 data decrypt failed Failed to decrypt the
data.
2019 time over two hours The period is more than
two hours.
2020 Only third-party clouds Only third-party cloud
are supported services are supported.
2021 Illegal email The email address is
incorrect.
2022 Illegal phone The mobile phone
number is incorrect.
2023 user exist The user already exists.
2024 device file path is not The file path on the
standardized device is invalid.
2025 device and file path The device and file path
mismatch do not match.
2026 ip failed to get Failed to get the IP
address.
2027 size too large The size is too large.
2028 encryption token expire The token has expired.
2029 session status is invalid The session status is
invalid.
2030 virtual scan only Virtual scanning is
supports ay region currently only available
in China Data Center.
2031 third-party platform Third-party authorization
authorization failed failed.

9 / 11
3 Service error codes

Error codes Error message Description

2032 app pushed request The request_id already


unique ID is duplicate exists. Idempotency is
required.
2033 more than 1000 app The number of users who
message push users receive the app push
notifications exceeds the
upper limit.
2037 the username has been The username has
bound by another already been bound with
username type another username type.
2041 operator name is exist The operator’s
username already exists.
2042 operator not exist The operator does not
exist.
2043 operator uuid not exist The operator’s UUID
does not exist.
2044 operator ip not exist The operator’s IP
address does not exist.
2045 operator ip has bind The operator’s IP
address has already been
bound.
2046 operator uuid has bind The operator’s UUID has
already been bound.
2047 this device is frozen by The device is frozen.
user, cannot command
2050 the infrared code The specified infrared
corresponding to the key code does not exist.
does not exist
2051 send infrared command Failed to send infrared
failed commands.

10 / 11
3 Service error codes

Error codes Error message Description

2052 not support the The command to set the


command to set specific specified temperature is
temperature not supported.
2053 the matching infrared The specified infrared
code is invalid code is invalid.
2054 the sub-device does not The sub-device does not
exist exist.
2055 not support the device This device is not
supported.
2056 device has bind or not The device has already
active been bound or it is
inactive.
2060 failed to add user, please Failed to add the user.
try it later
2061 message push config are The push notification
not set configuration is not
completed.
2062 data already exists The data already exists.
2063 other zigbee device is Another Zigbee device is
upgrading being updated.
2064 device version is the The device version is
latest up-to-date.
2101 duplicate naming under The device name already
the device exists.
2401 username or password A wrong username or
wrong password is entered
when logging in to the
mobile app. Check again
or reset your password.

11 / 11

You might also like