OpenWonderLabs / SwitchBotAPI

SwitchBot Open API Documents
849 stars 70 forks source link

Request for New API Command: unlockWithoutLatch (Switchbot Lock Pro) #310

Open HolgerRichter opened 4 months ago

HolgerRichter commented 4 months ago

Current Situation

I am currently integrating my SwitchBot lock with OpenHAB and have encountered an issue. While the SwitchBot app allows me to "unlock" the door without opening the latch, I am unable to achieve this through the SwitchBot API.

For my setup, it is essential to keep the door locked between 22:00 and 06:00. However, when I use the API to send the unlock command, the door latch is also released, leaving the door completely open.

Proposed Change

I propose the addition of a new API command, such as unlockWithoutLatch, that would unlock the door without releasing the latch. This would align the API functionality with what is currently available in the SwitchBot app and provide greater control for automation setups.

Additional Context

No response

oO-Markus-Oo commented 3 months ago

Just installed the Lock Pro one week ago - and it is really perfect. But one of my biggest issues is the problem that we can't distinguish between "unlock" and "door open / latched" in the API. Any news about it?

HolgerRichter commented 2 weeks ago

This functionality is crucial for many users who rely on automation to manage their locks. The ability to "unlock without releasing the latch" is an essential safety and convenience feature, particularly in situations where doors need to remain closed but unlocked, such as during specific security windows. Importantly, this feature is already implemented in the SwitchBot app, so it's not a matter of creating new functionality, but simply exposing it through the API. Given that the underlying feature exists, the complexity and effort to add this to the API should be relatively minimal.

From a customer perspective, this feature represents a significant added value. In fact, this functionality is something I urgently need, as it’s typically only available in motorized locks that cost ten times more here in Germany. By implementing this feature in the API, SwitchBot could tap into a market that is currently underserved, offering a much more affordable solution compared to high-end motorized locks. This could be a strong argument to increase sales, as it would make the product far more appealing to customers like myself who require this advanced level of control.

At the moment, this limitation is preventing me from fully integrating the system with my office door. I need the door to be locked between 18:00 and 08:00 but remain unlocked during the rest of the day, while still using an electric door opener. This API command would make SwitchBot much more competitive in markets where such automation setups are highly sought after.