home-api

家庭内デバイスをまとめて操作する Go / Echo ベースの API サーバーです。

対応サービス

• SwitchBot
• eWeLink
• Sesame
• Echonet Lite
• InfluxDB への操作ログ保存

開発

依存関係:

go mod download

テスト:

go test ./...

OpenAPI docs 再生成:

make docs

ビルド:

make build

ローカル起動:

make run

設定

実行時の設定は .env または環境変数で渡します。

主な環境変数:

• HOME_API_KEY
• SWITCHBOT_TOKEN
• SWITCHBOT_SECRET
• EWELINK_APP_ID
• EWELINK_APP_SECRET
• INFLUXDB_URL
• INFLUXDB_TOKEN
• SESAME_API_KEY
• SESAME_SECRET_KEY

注意

• .env とビルド済み binary は Git 管理しません。
• token、API key、secret、秘密鍵は commit しません。

作業ルール

小さな修正は main に直接 commit/push して構いません。複数 AI や大きめの変更では agent/<agent-name>/<task-slug> ブランチを使います。