SwitchBotAPI icon indicating copy to clipboard operation
SwitchBotAPI copied to clipboard

Missing Documentation on Obtaining a List of Shade Groups

Open jbasen opened this issue 9 months ago • 1 comments

Analysis

The API includes URLs for obtaining a list of devices with their device IDs and a list of scenes with the IDs. However, there is no documented way to obtain a list of Shade Groups with their IDs. This makes it impossible to open/close a shade group using the API.

Expected Behavior

A URL that returns a list of shade groups with their IDs should be included in the API documentation.

Steps To Reproduce

N/A

Logs

N/A

Configuration

N/A

Environment

  • OS: N/A
  • Software: N/A
  • Node: N/A
  • npm: N/A

Additional Context

No response

jbasen avatar Feb 12 '25 13:02 jbasen

I wanted to add that I have successfully used the https command:

https://api.switch-bot.com/v1.1/devices

to retrieve the list of the user's devices. However, I've tried the following commands and none of them will allow me to retrieve the list of shade groups:

https://api.switch-bot.com/v1.1/groups https://api.switch-bot.com/v1.1/shadegroups https://api.switch-bot.com/v1.1/shades https://api.switch-bot.com/v1.1/sgroups

These are the ones I thought might work but they all return a 403 error code.

Thanks

jbasen avatar Feb 13 '25 02:02 jbasen