Get Unbound Unlocking Methods

Last Updated on : 2024-08-15 07:40:09download

Get the list of unlocking methods that are not bound with all members.

API address

GET: /v1.0/devices/{device_id}/door-lock/unassigned-keys

Request parameter

Parameter nameTypeINRequiredDescription
device_idStringuritrueThe device ID.
unlock_typeStringuritrueThe type of the unlocking method. Valid values:
  • fingerprint: Unlock with fingerprint.
  • password: Unlock with password.
  • card: Unlock with card.
  • remoteControl: Unlock with remote control.

Return parameter

Parameter nameTypeDescription
resultUnlockVO

Description of result

Parameter nameTypeDescription
unlock_keysListThe list of unlocking methods

Description of unlock_keys

Parameter nameTypeDescription
unlock_noIntegerThe ID of the unlocking method. That is the flag of each unlocking method such as password, fingerprint, and card.
unlock_typeStringThe type of the unlocking method. Valid values:
  • fingerprint: Unlock with fingerprint.
  • password: Unlock with password.
  • card: Unlock with card.
  • remoteControl: Unlock with remote control.
hijackBooleanIndicates whether duress alarms are enabled.

Request example

GET: /v1.0/devices/vdevo15345926009****/door-lock/unassigned-keys?unlock_type=card

Return example

{
    "result": {
        "unlock_keys": [
            {
                "unlock_no": 3,
                "unlock_type": "card"
            }
        ]
    },
    "t": 1593843316481,
    "success": true
}

Error code

For more information, see error code.