Play with SwitchBot API

In this project, You use SwitchBot API to get parameters from your SwitchBot devices.

Environment

• Python 3
• python-dotenv
  • https://pypi.org/project/python-dotenv/
• SwitchBot API v1.1
  • https://github.com/OpenWonderLabs/SwitchBotAPI

Get Secret Key and Token

check How to obtain a Token? from SwitchBot official site.

get Device ID

You need device id to get parameters from your SwitchBot.

1. Install python-dotenv

pip install python-dotenv

2. Create .env file

you can use .env.example

cp .env.example .env

3. Edit .env file

set your secret key and token you got from the previous step

vi .env

4. Run

python3 get_device_id.py

sample response

{'body': {'deviceList': [{'deviceId': 'XXXXXXXXXXXXXXXX',
                          'deviceName': 'XXXXXXXXXXXXXXXX',
                          'deviceType': 'XXXXXXXXXXXXXXXX',
                          'enableCloudService': True,
                          'hubDeviceId': ''}],
 'message': 'success',
 'statusCode': 100}

Use deviceId in the next step.

get Response

You can get the response from your SwitchBot device.

python3 get_response.py $KEY $DEVICE_ID

• $KEY

  the key you want to get from your SwitchBot device. check here.

• $DEVICE_ID

  the device id you got from the previous step.

Example

I want to get the temperature from Hub 2.

python3 get_response.py temperature "my_device_id"

I get below response.

25.5

And more

• get temperature and monitor with zabbix