Example Http request for Smart Lock States

Nuki APIs
1

Hello Nuki-developers&Support-Team!
In a student project, my team and I work on a web application for controlling the Nuki lock 2.0 via the Web API.
The documentation says in point 5. “Smart Lock States”, that it is possible to request the state of the lock. We tried many https-requests, but none of them worked. (e.g. Post/Get https://api.nuki.io/smartlock/{ID}/state or https://api.nuki.io/smartlock//{ID}/state/locked, are getting 404 errors back)
Here are the supposed states from the docu:

state The current state of the Nuki Smart Lock
0 uncalibrated
1 locked
2 unlocking
3 unlocked
4 locking
…

Could someone provide an example https-request how to get the information? That would be great. Maybe you could integrate more example requests in the documentation in general. We are looking forward to your answers!

Best regards,
Lena Schramm

2

Have a look at the PDF linked on top of the API page: https://developer.nuki.io/page/nuki-web-api-1-3-0/3

It includes example curl calls, which should work on every UNIX command line.

3

Hi, thanks again for the fast reply!

I had a look at the docu at https://api.nuki.io/#/, and didn’t find the request that I wanted, but tried out the request Get https://api.nuki.io/smartlock/{ID} again.
I saw that everything that we need regarding the smart lock state is exactly there in the response of this command :smiley:

We always thought it would be separate commands, like the smart lock actions, that’s why we got confused about it, 5. Lock States looks very similar to 6. Smart Lock Actions in the docu. Maybe a small thing you could change in the Documentation, write above the lock state that people have only do the GET request with Smartlock ID and they will find everything that is defined there, like the mode, the state etc :slight_smile:

Have a nice weekend!
Lena Schramm