Cloud Services API ReferenceAdvanced Device ServicesExtension APIsThird-Party Industry Device CapabilitiesSmart Access Control ServiceSmart Access Users Batch OperationsBulk Add Faces

Bulk Add Faces

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

Send an adding command to a specified access control device to add faces for the users in bulk.

API address

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

Request parameter

Parameter name	Type	IN	Required	Description
device_id	String	uri	true	The ID of a Tuya device.

Description of body

Parameter name	Type	IN	Required	Description
face_list	List		true	The list of faces.

Description of face_list

Parameter name	Type	Required	Description
person_id	String	true	Tuya user ID.
face_id	String	true	The face ID.
url	String	true	The URL of the face image.

Return parameter

Parameter name	Type	Description
result	CmdIssueBatchResultResponse	The returned result.

Description of result

Parameter name	Type	Description
sn_list	List	The command record ID.

Request example

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

{
  "face_list": [
    {
      "person_id": "123****",
      "face_id": "faceId****",
      "url": "http://****.jpg"
    },
    {
      "person_id": "123****",
      "face_id": "faceId****",
      "url": "http://****.jpg"
    }
  ]
}

Return example

{
    "result": {
        "sn_list": [
            "133****",
            "132****"
        ]
    },
    "t": 1561456817168,
    "success": true
}

Error code

For more information, see error code.

Prev DocBulk Delete Faces

Next DocBulk Delete QR Codes