Add Person

Last Updated on : 2023-06-20 14:54:11

Send a command to a specified elevator controller to add a specified person.

API address

POST: /v1.0/elevator-control/{device_id}/persons/{person_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.

Description of body

Parameter name	Type	Required	Description
name	String	false	The name of a specified person.
id_card	String	false	The identity card number of a specified person.
phone	String	false	The mobile phone number.
begin_time	Long	true	The time when the validity period starts.
end_time	Long	true	The time when the validity period ends.
floor_auth_list	List	false	A list of the authorized floors.
secret_key	String	false	The 32-digit secret key for a specified person.
refresh_time	Long	false	The time interval when the QR code is refreshed. Unit: milliseconds.

Return parameter

Parameter name	Type	Description
result	CmdIssueResultResponse	The returned result.

Description of result

Parameter name	Type	Description
sn	String	The ID of a specified command record.

Request example

POST: /v1.0/elevator-control/6ce****/persons/123****

{
  "begin_time": 1582959882104,
  "end_time": 1661666512292,
  "id_card": "330****",
  "name": "John",
  "phone": "135****",
  "floor_auth_list": [
    1,
    2,
    3
  ],
  "secret_key": "abc123***",
  "refresh_time": 300000
}

Return example

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

Error code

For more information, see error code.

Prev DocUpdate Person

Next DocElevator Control Face Management