Cloud Services API ReferenceAdvanced Device ServicesExtension APIsThird-Party Industry Device CapabilitiesElevator Control ServiceCall Elevator CommandSend Elevator Call Command

Send Elevator Call Command

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

Send a call command to a specified elevator controller. After receiving the command, the elevator controller dispatches an elevator to a specified floor.

API address

POST: /v1.0/elevator-control/{device_id}/persons/{person_id}/actions/call

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
type	String	true	The type of an elevator call. Valid values: `in`: Call an elevator by car call. `out`: Call an elevator by hall call. `unify`: Call an elevator by car call and hall call.
start_floor	Integer	true	The floor from which the elevator starts.
end_floor	Integer	true	The floor at which the elevator arrives.

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****/actions/call

{
  "type": "in",
  "startFloor": 1,
  "endFloor": 5
}

Return example

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

Error code

For more information, see error code.

Prev DocCall Elevator Command

Next DocVehicle Service