Cloud Services API ReferenceAdvanced Device ServicesExtension APIsThird-Party Industry Device CapabilitiesSmart Access Control ServiceSmart Access Face ManagementAdd Face Data

Add Face Data

Last Updated on : 2023-06-20 14:54:08download

Send an adding command to a specified access control device to add the information about a specified face. The maximum number of queries per second (QPS) for a single account to call this API is 5.

API address

POST: /v1.0/access-control/{device_id}/persons/{person_id}/faces/{face_id}

Request parameter

Parameter name	Type	IN	Required	Description
device_id	String	uri	true	The ID of a Tuya device.
person_id	String	uri	true	The ID of a specified person.
face_id	String	uri	true	The face ID.

Description of body

Parameter name	Type	IN	Required	Description
url	String		true	The URL of a specified face image.

Return parameter

Parameter name	Type	Description
result	CmdIssueResultResponse	The returned result.

Description of result

Parameter name	Type	Description
sn	String	The command record ID.

Request example

POST: /v1.0/access-control/6ce****/persons/123****/faces/faceId****

{
  "url": "http://****.jpg"
}

Return example

{
    "result": {
        "sn": "133****"
    },
    "t": 1561456817168,
    "success": true
}

Error code

For more information, see error code.

Prev DocSmart Access Face Management

Next DocDelete Face