myStrom（獨立出版商）

myStrom 是一家生產智能家居設備的瑞士公司。使用此連接器，可以透過 REST API 控制 myStrom 裝置。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	托馬斯·波西泰克
URL	https://aka.ms/poszytek
Email	tomasz@poszytek.eu

連接器中繼資料
Publisher	托馬斯·波西泰克
網站	https://mystrom.ch/
隱私策略	https://mystrom.ch/privacy-policy/
類別	物聯網;生活方式和娛樂

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

Authentication	提供您的電子郵件和密碼來取得 authToken。
切換裝置	裝置切換要求可用來變更裝置的狀態並設定其參數
刪除 Webhook	依裝置識別碼刪除 Webhook
取得 Webhook	依裝置識別碼取得 Webhook
取得場景	獲取所有用戶場景的列表
取得裝置	依識別碼取得裝置
取得裝置	獲取所有用戶設備的列表
執行場景	依 ID 執行場景
建立 Webhook	建立 Webhook

Authentication

作業識別碼：: Auth

提供您的電子郵件和密碼來取得 authToken。

參數

名稱	機碼	必要	類型	Description
電子郵件	email	True	string	myStrom 帳戶電子郵件
密碼	password	True	password	myStrom 帳戶密碼

傳回

名稱	路徑	類型	Description
驗證權杖	authToken	string	要用來驗證其他要求的權杖。

切換裝置

作業識別碼：: ToggleDevice

裝置切換要求可用來變更裝置的狀態並設定其參數

參數

名稱	機碼	必要	類型	Description
裝置標識碼	Device ID	True	string	裝置標識碼
顏色	color		string	我們設定燈泡的顏色。 HSV 的形式 <為 UINT 0..360>;<UINT 0..100>;<UINT 0..100>
坡道	ramp		integer	從光源當前狀態到新狀態的轉換時間。 [毫秒]
暗淡值	value		integer	支援暗淡動作之裝置的暗淡值
行動	action	True	string	切換動作
驗證權杖	authToken	True	password	驗證權杖

傳回

名稱	路徑	類型	Description
Code	code	integer
Message	message	string
顏色	color	string	HSV 格式的當前顏色。

刪除 Webhook

作業識別碼：: DeleteWebhook

依裝置識別碼刪除 Webhook

參數

名稱	機碼	必要	類型	Description
裝置標識碼	Device ID	True	string	裝置標識碼
驗證權杖	authToken	True	password	驗證權杖

傳回

名稱	路徑	類型	Description
Code	code	integer
Message	message	string

取得 Webhook

作業識別碼：: GetWebhook

依裝置識別碼取得 Webhook

參數

名稱	機碼	必要	類型	Description
裝置標識碼	Device ID	True	string	裝置標識碼
驗證權杖	authToken	True	password	驗證權杖

取得場景

作業識別碼：: GetScenes

獲取所有用戶場景的列表

參數

名稱	機碼	必要	類型	Description
驗證權杖	authToken	True	password	驗證權杖

傳回

名稱	路徑	類型	Description
場景	scenes	array of object	場景
場景 ID	scenes.id	string
名稱	scenes.name	string

取得裝置

作業識別碼：: GetDevice

依識別碼取得裝置

參數

名稱	機碼	必要	類型	Description
裝置標識碼	Device ID	True	string	裝置標識碼
驗證權杖	authToken	True	password	驗證權杖

傳回

名稱	路徑	類型	Description
裝置標識碼	id	string
名稱	name	string
Power	power	float	電流功耗（W）。
類型	type	string	裝置的類型。
State	state	string	開啟或關閉。
顏色	color	string	HSV 格式。
溫度	temperature	float	當前溫度（C）。
亮度	brightness	integer

取得裝置

作業識別碼：: GetDevices

獲取所有用戶設備的列表

參數

名稱	機碼	必要	類型	Description
驗證權杖	authToken	True	password	驗證權杖

傳回

名稱	路徑	類型	Description
devices	devices	array of object	devices
裝置標識碼	devices.id	string
名稱	devices.name	string
Power	devices.power	float	電流功耗（W）。
類型	devices.type	string	裝置的類型。
State	devices.state	string	開啟或關閉。
顏色	devices.color	string	HSV 格式。
溫度	devices.temperature	float	當前溫度（C）。
亮度	devices.brightness	integer

執行場景

作業識別碼：: ExecuteScene

依 ID 執行場景

參數

名稱	機碼	必要	類型	Description
場景 ID	Scene ID	True	string	場景 ID
驗證權杖	authToken	True	password	驗證權杖

傳回

名稱	路徑	類型	Description
Code	code	integer
Message	message	string

建立 Webhook

作業識別碼：: CreateWebhook

建立 Webhook

參數

名稱	機碼	必要	類型	Description
裝置標識碼	Device ID	True	string	裝置標識碼
Webhook 定義	webhook	True	string	Webhook 定義，範例：{“url”：“http://example.com"，”config“：{”state“： true，”power“：true}}
驗證權杖	authToken	True	password	驗證權杖

傳回

名稱	路徑	類型	Description
Code	code	integer
Message	message	string