Register Device
Last Updated on : 2022-05-05 10:00:19
Register a third-party device in Tuya's ecosystem.
API address
POST: /v1.0/iot-03/3rdcloud/devices/{third_cloud_device_id}/register
Request parameter
| Parameter name | Type | IN | Required | Description |
|---|---|---|---|---|
| third_cloud_device_id | String | uri | true | The ID of a specified device of a partner. It can be a unique readable identifier of the device, such as device SN, MAC address, or IMEI. The length should not exceed 32 characters. |
Description of body
| Parameter name | Type | IN | Required | Description |
|---|---|---|---|---|
| device_name | String | body | true | The name of a specified device, with no more than 50 characters. |
| product_id | String | body | true | The ID of a Tuya product. |
| options | Object | body | false | The extension information about a specified device. Valid values:
|
Return parameter
| Parameter name | Type | Description |
|---|---|---|
| result | Object | The returned result. |
| code | Boolean | The response code. It is empty when the operation succeeded. |
| msg | String | The error message if the API call fails. It is empty if the operation succeeded. |
| success | Boolean | Indicates whether the operation is successful. Valid values:
|
| t | Long | The 13-digit timestamp of a response. |
Description of result
| Parameter name | Type | Description |
|---|---|---|
| device_id | String | The ID of a Tuya device. |
Request example
POST: /v1.0/iot-03/3rdcloud/devices/ A18007210830****/register
{
"device_name": "Test Device",
"product_id": "xz0uukkq5oce****",
"options": {
"mac": "48ea63fd****",
"installLocation": "****Jiangdun Road, Xihu District, Hangzhou City",
}
}
Return example
{
"result": {
"device_id": "6cf4171005d11e2ca7****"
},
"t": 1561456817168,
"success": true
}
Error code
For more information, see error code.
Is this page helpful?
YesFeedbackIs this page helpful?
YesFeedbackMarketing Cooperation
Business Cooperation
Customer Service
Media Inquiry
© 2023 Tuya Inc.