# OpenWonderLabs/SwitchBotAPI

SwitchBot Open API Documents

Repository: https://github.com/OpenWonderLabs/SwitchBotAPI
Canonical: https://ross.abutalabs.com/products/switchbotapi
License Family: other
Last push: 2026-07-24T03:51:04+00:00

## Health v2 (maintenance only)
Score: 75/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 94, release rhythm 35, longevity 100
- inputs: {"age_days": 2086, "days_push": 40, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1210, forks 84 (observed 2026-08-28T04:03:59.974945+00:00)

## What it is
Official documentation for the SwitchBot Open API v1.1, a REST API for controlling and monitoring SwitchBot smart home devices. It covers authentication with token signing, device control commands, scenes, and webhooks.

## Use cases
- control switchbot devices programmatically
- get smart plug or meter status via api
- automate curtain and bot devices from home assistant
- set up webhooks for device status changes
- sign api requests with open token and secret
- execute scenes remotely

## When to choose
- you own SwitchBot devices and want programmatic control
- you're building a home automation integration or dashboard
- you need device status polling or webhook events

## When to avoid
- you use other smart home brands' devices
- you need local-network-only control without cloud
- you want an SDK rather than raw REST API docs

## Facets
- artifact type: service
- maturity: active
- function: api-framework, webhook, auth, iot
- domain: iot, apis, documentation
- platform: cloud
- tags: smart-home, rest-api, api-documentation, switchbot, home-automation, device-control, automation, web-server

## Member repositories
- OpenWonderLabs/SwitchBotAPI (main) score 75

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:59.974945+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:18:09.262812+00:00, confidence not recorded.
  - readme: https://github.com/OpenWonderLabs/SwitchBotAPI (fetched 2026-08-28T04:03:59.974945+00:00, sha 15cca6135f2a)
- Data as of 2026-08-30T08:39:29.467469+00:00.