User Authority Management

Last Updated on : 2025-05-30 01:56:03download

API List

Request method	API	Description
POST	/v1.0/iot-02/third/spaces/{device_id}/persons/{person_id}	Add user authentication
DELETE	/v1.0/iot-02/third/spaces/{device_id}/persons/{person_id}	Cancel user authentication

Add user authentication

API Description

Provide the access control authentication for newly added Tuya users, once the user has been authorized then will grant the audio & video communication.

API Address

POST /v1.0/iot-02/third/spaces/{device_id}/persons/{person_id}

Request Parameters

Parameter	Type	Position	Description	Mandatory
device_id	String	URI	tuya device ID	Yes
person_id	String	URI	tuya user ID	Yes

Request Example

POST /v1.0/iot-02/third/spaces/002dj00118fe34d9****/persons/ay1534*****4744oIAa

Response Parameters

Parameter	type	Description
code	Integer	Response code (refer to the error code chapter)
success	Boolean	Request result. true: success false: failure
msg	String	Exception message. It is null when the request result is a success.
result	Object	Return object

Parameters in result

Parameter	type	description
device_id	String	Tuya device ID
person_id	String	Tuya user ID

Success Response Example

{
    "success": true,
    "result": {
        "device_id": "002dj00118fe34d9****",
        "person_id": "ay1534*****4744oIAa"
    }
}

Cancel user authentication

API Description

Cancel the user’s authentication, the user will be disenabled on audio & video communication once canceled.

API address

DELETE /v1.0/iot-02/third/spaces/{device_id}/persons/{person_id}

Request Parameters

Parameter	type	Position	description	Mandatory
device_id	String	URI	Tuya device ID	Yes
person_id	String	URI	Tuya user ID	Yes

Request Example

DELETE /v1.0/iot-02/third/spaces/002dj00118fe34d9****/persons/ay1534*****4744oIAa

Response Parameters

Parameter	Type	Description
code	Integer	response code (refer to detailed error code chapter)
success	Boolean	request success or not：（true:succeed， false：failed）
msg	String	Excemessage ssage.It is null when the result is success.
result	Object	Return object

**Parameter in result **

Parameter	Type	Description
device_id	String	tuya device ID
person_id	String	tuya user ID

Success Response Example

{
    "success": true,
    "result": {
        "device_id": "002dj00118fe34d9****",
        "person_id": "ay1534*****4744oIAa"
    }
}

Prev DocPassing Management

Next DocUser Information Management