I am testing the Web API for a potential business case in the near future.
I am trying to create temporary access for a user via the Web API and would like to receive a link in the response that can be used to open the lock during the defined validity period.
I have a Smart Lock Go connected to Nuki Web, and I also have Smart Hosting enabled. I can lock and unlock the device via the Web API, and I can create users, but I am unable to create temporary access.
I am running into issues with the code and type parameters.
If I set type to 13 and do not include code field, I receive the error:
“The supplied value ‘null’ for parameter ‘code’ is not valid.”
If I include a valid code (6 digits, not starting with 12, etc.), I receive the error:
“The supplied value ‘13’ for parameter ‘type’ is not valid.”
I do not have a keypad installed on the lock, and I am not intending to use one. My goal is simply to receive a link that can open the lock during the specified validity period.
Am I receiving these errors because I do not have a keypad installed?
If so, is there a type value that can be used without a keypad to generate a time‑limited unlock link?
If your smart lock doesn’t have a keypad attached, you’ll need to create an app invite instead. This will create a 9 digit code which the user is able to redeem in the Nuki app to operate the smart lock.
You can achieve this by leaving the “type” as 0 in your smartlockAuth request and omitting the “code”.
Check out page 26 for the section “Invite a User” within the API documentation for further details: Nuki Web API
Hi Andrew
Thank you for your reply. I will check that out.
Does this mean that if I get the keypad, then I can use type 13 and it will work without Nuki App with the pin code or link to open the lock and now it fails because I don’t have the keypad?
Kind Regards,
Erik
Correct, with a keypad you will be able to use type 13 and provide 6-digit numeric codes for access. If you only use keypad codes, then your guests/visitors will not need to install the Nuki app.