Access Code Requirements for Door Locks
Learn about the specific requirements and constraints for setting access codes on door locks.
Last updated
Was this helpful?
Learn about the specific requirements and constraints for setting access codes on door locks.
Last updated
Was this helpful?
Some models of door locks have specific requirements and constraints when it comes to setting PIN codes. It's essential to be aware of these to ensure seamless functionality and security. The requirements can be fetched by making a or (or ) request.
Sample set of access code requirements:
Request:
Response:
This property is denoted as supported_code_lengths
and contains an array of numbers. These numbers represent the various lengths (in terms of digits) allowed for a PIN code. For example, if the array contains [4, 6]
, it means the door lock can accept 4-digit or 6-digit PIN codes.
Example Payload:
Example Payload:
The code_constraints
property gives insight into various conditions or limitations that apply to PIN codes. Each constraint in the code_constraints
array is an object with at least the constraint_type
property.
Example Payload:
The constraint_type
property can be one of the following:
no_zeros
0
s cannot be used as digits in the pin code.
cannot_start_with_12
The pin code cannot start with the sequence of digits 12
.
no_triple_consecutive_ints
No more than 3 digits in a row can be consecutive or the same in the pin code.
cannot_specify_pin_code
A pin code cannot be specified - it has to be left empty and one will be generated by the lock provider.
pin_code_matches_existing_set
If a pin code is specified, it must match an existing set of pin codes used in the account (for example, pin code matches the code assigned to a user in the system).
start_date_in_future
For time-bound codes, the start date has to be in the future.
name_length
The name of the code has some restrictions on length. When the constraint_type
is name_length
, the constraint object has one or two additional properties called min_length
and max_length
to specify the length constraints.
The property max_active_codes_supported
indicates the total number of codes that can be simultaneously set on a door lock. For the door locks that accommodate , this count will includes future scheduled codes that are set on the lock.