Send Elevator Call Command

Last Updated on : 2023-06-15 05:26:43

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 nameTypeINRequiredDescription
device_idStringuritrueThe ID of a Tuya device.
person_idStringuritrueThe ID of a specified person.

Description of body

Parameter nameTypeINRequiredDescription
typeString trueThe 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_floorInteger trueThe floor from which the elevator starts.
end_floorInteger trueThe floor at which the elevator arrives.

Return parameter

Parameter nameTypeDescription
resultCmdIssueResultResponseThe returned result.

Description of result

Parameter nameTypeDescription
snStringThe 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.