Cloud Services API ReferenceSmart HomeSmart Home Basic ServiceSmart Home User ManagementSync Users

Sync Users

Last Updated on : 2023-06-20 15:34:46download

This API operation is used to sync user accounts. To suit your own business scenarios, you can create accounts and modify account information based on the sync parameters.

Note: - Once an account is created, you cannot modify the country code, username, and username type. Confirm the data when you create an account. - If you pass in the same username under the same application, the last password, nickname, or time zone ID of this user will be updated according to the specific sync parameters.

API address

POST: /v1.0/apps/{schema}/user

Request parameter

Parameter name	Type	IN	Required	Description
schema	String	uri	true	The channel identifier of the specified app.

Description of body

Parameter name	Type	IN	Required	Description
country_code	String	body	true	The code of the specified country or region.
username	String	body	true	The username.
password	String	body	true	The user's password. The original password encrypted with MD5 Hash is recommended.
username_type	Integer	body	true	The type of username. Valid values: `1`: mobile phone number. `2`: email address. `3`: others. Default value is `3`.
nick_name	String	body	false	The nickname.
time_zone_id	String	body	false	The ID of the specified time zone.

Return parameter

Parameter name	Type	Description
result	JSONObject	The returned result of synchronizing a user.

Description of result

Parameter name	Type	Description
uid	String	Tuya user ID.

Request example

POST: /v1.0/apps/testApp/user

{
  "country_code": "86",
  "username": "182*****678",
  "password": "c7fb2740c5f******4ed765a479fa",
  "username_type": 1,
  "time_zone_id": "Asia/Shanghai"
}

Return example

{
    "result": {
        "uid": "ay1534*****4744oIAa"
    },
    "success": true
}

Error code

For more information, see error code.

Prev DocSmart Home User Management

Next DocGet User Information