Remote Unlocking with Password

Last Updated on : 2023-12-07 03:33:58download

Remotely unlock a door with a password.

API address

POST: /v1.0/devices/{device_id}/door-lock/open-door

Request parameter

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

Description of body

Parameter name Type IN Required Description
password String false
  • Original password length: 6.
  • Password transmission encryption algorithm: AES.
  • Mode: ECB mode and PKCS7Padding.
  • Data block: 128 bits.
  • Secret key: To get the original key, decrypt the temporary key ticket_key with AES by using the accessKey that is issued by the Cloud Development Platform.
password_type String false The password is encrypted using a ticket.
ticket_id String false The ID of the temporary key.

Return parameter

Parameter name Type Description
result Boolean The returned result.

Request example

POST: /v1.0/devices/vdevo15345926009****/door-lock/open-door
{ "password": "65gbys77hhkk", "password_type": "xxxx", "ticket_id": "756***" }

Return example

{ "result": true, "t": 1542626129429, "success": true }

Error code

For more information, see error code.