mijiaAPI 1.3.10__tar.gz → 1.3.12__tar.gz

{mijiaapi-1.3.10 → mijiaapi-1.3.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mijiaAPI
-Version: 1.3.10
+Version: 1.3.12
 Summary: A Python API for Xiaomi Mijia
 License: GPLv3
 Author: Do1e

mijiaapi-1.3.12/mijiaAPI/__main__.py

@@ -0,0 +1,27 @@
+import argparse
+import sys
+
+from .login import mijiaLogin
+
+def parse_args(args):
+    parser = argparse.ArgumentParser(description="Mijia API CLI")
+    parser.add_argument(
+        '-i', '--login',
+        action='store_true',
+        help="Login by QR code and save cookies to file",
+    )
+    parser.add_argument(
+        '-c', '--cookie_path',
+        type=str,
+        help="Path to the cookies file",
+    )
+    return parser.parse_args(args)
+
+def main(args):
+    args = parse_args(args)
+    if args.login:
+        api = mijiaLogin(save_path=args.cookie_path)
+        auth = api.QRlogin()
+
+if __name__ == "__main__":
+    main(sys.argv[1:])

mijiaapi-1.3.12/mijiaAPI/apis.py

@@ -0,0 +1,186 @@
+from typing import Union
+import requests
+import requests.cookies
+
+from .utils import defaultUA, post_data, PostDataError
+
+
+class mijiaAPI(object):
+    def __init__(self, auth_data: dict):
+        """
+        初始化mijiaAPI对象。
+
+        Args:
+            auth_data (dict): 包含授权信息的字典，必须包含'userId'、'deviceId'、'ssecurity'和'serviceToken'。
+
+        Raises:
+            Exception: 当授权数据不完整时抛出异常。
+        """
+        if any(k not in auth_data for k in ['userId', 'deviceId', 'ssecurity', 'serviceToken']):
+            raise Exception('Invalid authorize data')
+        self.userId = auth_data['userId']
+        self.ssecurity = auth_data['ssecurity']
+        self.session = requests.Session()
+        self.session.headers.update({
+            'User-Agent': defaultUA,
+            'x-xiaomi-protocal-flag-cli': 'PROTOCAL-HTTP2',
+            'Cookie': f'PassportDeviceId={auth_data["deviceId"]};'
+                      f'userId={auth_data["userId"]};'
+                      f'serviceToken={auth_data["serviceToken"]};',
+        })
+
+    @staticmethod
+    def _post_process(data: dict) -> Union[list, bool]:
+        if data['code'] != 0:
+            raise Exception(f'Failed to get data, {data["message"]}')
+        return data['result']
+
+    @property
+    def available(self) -> bool:
+        """
+        检查API是否可用。
+
+        Returns:
+            bool: API可用返回True，否则返回False。
+        """
+        uri = '/home/device_list'
+        data = {"getVirtualModel": False, "getHuamiDevices": 0}
+        try:
+            post_data(self.session, self.ssecurity, uri, data)
+            return True
+        except PostDataError:
+            return False
+
+    def get_devices_list(self) -> dict:
+        """
+        获取设备列表。
+
+        Returns:
+            dict: 设备列表。
+        """
+        uri = '/home/device_list'
+        data = {"getVirtualModel": False, "getHuamiDevices": 0}
+        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+
+    def get_homes_list(self) -> list:
+        """
+        获取家庭列表。
+
+        Returns:
+            list: 家庭列表，包括房间信息。
+        """
+        uri = '/v2/homeroom/gethome'
+        data = {"fg": False, "fetch_share": True, "fetch_share_dev": True, "limit": 300, "app_ver": 7}
+        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+
+    def get_scenes_list(self, home_id: str) -> list:
+        """
+        获取场景列表。
+
+        在米家APP中通过"添加 -> 手动控制"设置。
+
+        Args:
+            home_id (str): 家庭ID，从get_homes_list获取。
+
+        Returns:
+            list: 场景列表。
+        """
+        uri = '/appgateway/miot/appsceneservice/AppSceneService/GetSceneList'
+        data = {"home_id": home_id}
+        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+
+    def run_scene(self, scene_id: str) -> bool:
+        """
+        运行场景。
+
+        Args:
+            scene_id (str): 场景ID，从get_scenes_list获取。
+
+        Returns:
+            bool: 操作结果。
+        """
+        uri = '/appgateway/miot/appsceneservice/AppSceneService/RunScene'
+        data = {"scene_id": scene_id, "trigger_key": "user.click"}
+        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+
+    def get_consumable_items(self, home_id: str) -> list:
+        """
+        获取耗材列表。
+
+        Args:
+            home_id (str): 家庭ID，从get_homes_list获取。
+
+        Returns:
+            list: 耗材列表。
+        """
+        uri = '/v2/home/standard_consumable_items'
+        data = {"home_id": int(home_id), "owner_id": self.userId}
+        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+
+    def get_devices_prop(self, data: list) -> list:
+        """
+        获取设备属性。
+
+        Args:
+            data (list): 设备属性请求列表，每项为包含以下键的字典：
+                - did: 设备ID，从get_devices_list获取
+                - siid: 服务ID，从 https://home.miot-spec.com/spec/{model} 获取，model从get_devices_list获取
+                - piid: 属性ID，从 https://home.miot-spec.com/spec/{model} 获取，model从get_devices_list获取
+
+                示例(yeelink.light.lamp4)：
+                [
+                    {"did": "1234567890", "siid": 2, "piid": 2}, # 获取亮度
+                    {"did": "1234567890", "siid": 2, "piid": 3}, # 获取色温
+                ]
+
+        Returns:
+            list: 设备属性信息列表。
+        """
+        uri = '/miotspec/prop/get'
+        data = {"params": data}
+        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+
+    def set_devices_prop(self, data: list) -> list:
+        """
+        设置设备属性。
+
+        Args:
+            data (list): 设备属性设置列表，每项为包含以下键的字典：
+                - did: 设备ID，从get_devices_list获取
+                - siid: 服务ID，从 https://home.miot-spec.com/spec/{model} 获取，model从get_devices_list获取
+                - piid: 属性ID，从 https://home.miot-spec.com/spec/{model} 获取，model从get_devices_list获取
+                - value: 要设置的值
+
+                示例(yeelink.light.lamp4)：
+                [
+                    {"did": "1234567890", "siid": 2, "piid": 2, "value": 50} # 设置亮度为50%
+                    {"did": "1234567890", "siid": 2, "piid": 3, "value": 2700} # 设置色温为2700K
+                ]
+
+        Returns:
+            list: 操作结果。
+        """
+        uri = '/miotspec/prop/set'
+        data = {"params": data}
+        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+
+    def run_action(self, data: dict) -> dict:
+        """
+        执行设备动作。
+
+        Args:
+            data (dict): 动作请求，包含以下键：
+                - did: 设备ID，从get_devices_list获取
+                - siid: 服务ID，从 https://home.miot-spec.com/spec/{model} 获取，model从get_devices_list获取
+                - aiid: 动作ID，从 https://home.miot-spec.com/spec/{model} 获取，model从get_devices_list获取
+                - value: 参数列表
+
+                示例(xiaomi.feeder.pi2001)：
+                {"did": "1234567890", "siid": 2, "aiid": 1, "value": [2]}, # 远程喂食2份
+
+        Returns:
+            dict: 操作结果。
+        """
+        uri = '/miotspec/action'
+        data = {"params": data}
+        return self._post_process(post_data(self.session, self.ssecurity, uri, data))

{mijiaapi-1.3.10 → mijiaapi-1.3.12}/mijiaAPI/devices.py

@@ -11,8 +11,13 @@ from .logger import logger
 class DevProp(object):
     def __init__(self, prop_dict: dict):
         """
-        Initialize the property object 初始化属性对象
-        :param prop_dict:
+        初始化属性对象。
+
+        Args:
+            prop_dict (dict): 属性字典。
+
+        Raises:
+            ValueError: 如果属性类型不受支持。
         """
         self.name = prop_dict['name']
         self.desc = prop_dict['description']
@@ -27,8 +32,10 @@ class DevProp(object):
 
     def __str__(self):
         """
-        String representation of the property 返回属性的名称、描述、类型、读写权限、单位和范围
-        :return:
+        返回属性的字符串表示。
+
+        Returns:
+            str: 属性的名称、描述、类型、读写权限、单位和范围。
         """
         lines = [
             f"  {self.name}: {self.desc}",
@@ -44,11 +51,23 @@ class DevProp(object):
 
 class DevAction(object):
     def __init__(self, act_dict: dict):
+        """
+        初始化动作对象。
+
+        Args:
+            act_dict (dict): 动作字典。
+        """
         self.name = act_dict['name']
         self.desc = act_dict['description']
         self.method = act_dict['method']
 
     def __str__(self):
+        """
+        返回动作的字符串表示。
+
+        Returns:
+            str: 动作的名称和描述。
+        """
         return f'  {self.name}: {self.desc}'
 
 
@@ -62,16 +81,29 @@ class mijiaDevices(object):
             sleep_time: Optional[Union[int, float]] = 0.5
     ):
         """
-        Initialize the device object 初始化设备对象
-        若未提供设备信息，则根据设备名称获取设备信息，若两者均未提供，则抛出异常
-        若提供了设备信息的同时提供了设备名称，则以设备信息为准
-        :param api: 米家API对象
-        :param dev_info: 设备信息字典（可选）
-        :param dev_name: 设备名称（可选）
-        :param did: 设备ID（可选）
-        :param sleep_time: 调用设备属性的间隔时间（可选，默认0.5秒）
+        初始化设备对象。
+
+        如果未提供设备信息，则根据设备名称获取设备信息。如果两者均未提供，则抛出异常。
+        如果同时提供了设备信息和设备名称，则以设备信息为准。
+
+        Args:
+            api (mijiaAPI): 米家API对象。
+            dev_info (dict, optional): 设备信息字典，从get_device_info获取。默认为None。
+            dev_name (str, optional): 设备名称，从get_devices_list获取。默认为None。
+            did (str, optional): 设备ID，如未指定，则需要在调用get/set时指定。默认为None。
+            sleep_time ([int, float], optional): 调用设备属性的间隔时间。默认为0.5秒。
+
+        Raises:
+            RuntimeError: 如果dev_info和dev_name都未提供。
+            ValueError: 如果找不到指定设备或找到多个同名设备。
+
+        Note:
+            - 如果同时提供了dev_info和dev_name，则以dev_info为准。
+            - 如果只提供了dev_name，则根据名称自动获取设备信息。
+            - 如果只提供了dev_info，则直接使用该信息。
         """
-        assert dev_info is not None or dev_name is not None, "Either 'dev_info' or 'dev_name' must be provided."
+        if dev_info is None and dev_name is None:
+            raise RuntimeError("Either 'dev_info' or 'dev_name' must be provided.")
         if dev_info is not None and dev_name is not None:
             logger.warning("Both 'dev_info' and 'dev_name' provided. Using 'dev_info' for initialization.")
 
@@ -106,8 +138,10 @@ class mijiaDevices(object):
 
     def __str__(self) -> str:
         """
-        String representation of the device 返回设备的属性和动作列表
-        :return: 设备的属性和动作列表
+        返回设备的字符串表示。
+
+        Returns:
+            str: 设备的属性和动作列表。
         """
         prop_list_str = '\n'.join(filter(None, (str(v) for k, v in self.prop_list.items() if '_' not in k)))
         action_list_str = '\n'.join(map(str, self.action_list.values()))
@@ -115,13 +149,21 @@ class mijiaDevices(object):
                 f"Properties:\n{prop_list_str if prop_list_str else 'No properties available'}\n"
                 f"Actions:\n{action_list_str if action_list_str else 'No actions available'}")
 
-    def set(self, name: str, did: str, value: Union[bool, int]) -> Union[bool, int]:
+    def set(self, name: str, did: str, value: Union[bool, int, float, str]) -> bool:
         """
-        Set property value 设置设备的属性值
-        :param name: 属性名称
-        :param did: 设备ID
-        :param value: 属性值
-        :return: 执行结果（True/False）
+        设置设备的属性值。
+
+        Args:
+            name (str): 属性名称。
+            did (str): 设备ID。
+            value (Union[bool, int, float, str]): 属性值。
+
+        Returns:
+            bool: 执行结果（True/False）。
+
+        Raises:
+            ValueError: 如果属性不存在、属性为只读或值无效。
+            RuntimeError: 如果设置属性失败。
         """
         if name not in self.prop_list:
             raise ValueError(f'Unsupported property: {name}, available properties: {list(self.prop_list.keys())}')
@@ -170,13 +212,20 @@ class mijiaDevices(object):
         sleep(self.sleep_time)
         return result['code'] == 0
 
-    def set_v2(self, name: str, value: Union[bool, int], did: Optional[str] = None) -> Union[bool, int]:
+    def set_v2(self, name: str, value: Union[bool, int, float, str], did: Optional[str] = None) -> bool:
         """
-        Set property value_v2 设置设备的属性值_v2（需在实例化时指定did）
-        :param name: 属性名称
-        :param value: 属性值
-        :param did: 设备ID（若未指定，则使用实例化时的did）
-        :return: 执行结果（True/False）
+        设置设备的属性值（v2版本，需在实例化时指定did或在调用时提供）。
+
+        Args:
+            name (str): 属性名称。
+            value (Union[bool, int, float, str]): 属性值。
+            did (str, optional): 设备ID。如未指定，则使用实例化时的did。默认为None。
+
+        Returns:
+            bool: 执行结果（True/False）。
+
+        Raises:
+            ValueError: 如果未指定设备ID。
         """
         if did is not None:
             return self.set(name, did, value)
@@ -185,12 +234,20 @@ class mijiaDevices(object):
         else:
             raise ValueError('Please specify the did')
 
-    def get(self, name: str, did: Optional[str] = None) -> Union[bool, int]:
+    def get(self, name: str, did: Optional[str] = None) -> Union[bool, int, float, str]:
         """
-        Get property value 获取设备的属性值
-        :param name: 属性名称
-        :param did: 设备ID（若未指定，则使用实例化时的did）
-        :return: 属性值
+        获取设备的属性值。
+
+        Args:
+            name (str): 属性名称。
+            did (str, optional): 设备ID。如未指定，则使用实例化时的did。默认为None。
+
+        Returns:
+            Union[bool, int, float, str]: 属性值。
+
+        Raises:
+            ValueError: 如果未指定设备ID、属性不存在或属性为只写。
+            RuntimeError: 如果获取属性失败。
         """
         if did is None:
             did = self.did
@@ -213,12 +270,16 @@ class mijiaDevices(object):
         sleep(self.sleep_time)
         return result['value']
 
-    def __setattr__(self, name: str, value: Union[bool, int]) -> None:
+    def __setattr__(self, name: str, value: Union[bool, int, float, str]) -> None:
         """
-        Set property value 设置设备的属性值（需在实例化时指定did）
-        :param name: 属性名称
-        :param value: 属性值
-        :return: None
+        设置设备的属性值（通过对象属性方式，需在实例化时指定did）。
+
+        Args:
+            name (str): 属性名称。
+            value (Union[bool, int, float, str]): 属性值。
+
+        Raises:
+            RuntimeError: 如果设置属性失败。
         """
         if 'prop_list' in self.__dict__ and name in self.prop_list:
             if not self.set_v2(name, value):
@@ -226,11 +287,15 @@ class mijiaDevices(object):
         else:
             super().__setattr__(name, value)
 
-    def __getattr__(self, name: str) -> Union[bool, int]:
+    def __getattr__(self, name: str) -> Union[bool, int, float, str]:
         """
-        Get property value 获取设备的属性值（需在实例化时指定did）
-        :param name: 属性名称
-        :return: 属性值
+        获取设备的属性值（通过对象属性方式，需在实例化时指定did）。
+
+        Args:
+            name (str): 属性名称。
+
+        Returns:
+            Union[bool, int, float, str]: 属性值。
         """
         if 'prop_list' in self.__dict__ and name in self.prop_list:
             return self.get(name)
@@ -245,12 +310,20 @@ class mijiaDevices(object):
             **kwargs
     ) -> bool:
         """
-        Run action 运行设备动作
-        :param name: 动作名称
-        :param did: 设备ID（若未指定，则使用实例化时的did）
-        :param value: 动作参数（若动作不需要参数，则不需要指定）
-        :param kwargs: 其它动作参数（若动作不需要参数，则不需要指定）
-        :return: 执行结果（True/False）
+        运行设备动作。
+
+        Args:
+            name (str): 动作名称。
+            did (Optional[str], optional): 设备ID。如未指定，则使用实例化时的did。默认为None。
+            value (Optional[Union[list, tuple]], optional): 动作参数。如动作不需要参数，则不需指定。默认为None。
+            **kwargs: 其它动作参数，如智能音箱的in参数[run_action('execute-text-directive', _in=['空调调至26度', True])]。
+
+        Returns:
+            bool: 执行结果（True/False）。
+
+        Raises:
+            ValueError: 如果未指定设备ID、动作不存在或参数无效。
+            RuntimeError: 如果运行动作失败。
         """
         if did is None:
             did = self.did
@@ -283,9 +356,16 @@ class mijiaDevices(object):
 
 def get_device_info(device_model: str) -> dict:
     """
-    Get device info 获取设备信息
-    :param device_model: 设备型号
-    :return: 设备信息字典
+    获取设备信息，用于初始化mijiaDevices对象。
+
+    Args:
+        device_model (str): 设备型号，从get_devices_list获取。
+
+    Returns:
+        dict: 设备信息字典。
+
+    Raises:
+        RuntimeError: 如果获取设备信息失败。
     """
     response = requests.get(deviceURL + device_model)
     if response.status_code != 200:

{mijiaapi-1.3.10 → mijiaapi-1.3.12}/mijiaAPI/login.py

@@ -1,9 +1,9 @@
+from typing import Optional
 import hashlib
 import json
 import os
 import random
 import string
-import sys
 import time
 from urllib import parse
 
@@ -17,15 +17,27 @@ from .logger import logger
 
 class LoginError(Exception):
     def __init__(self, code: int, message: str):
+        """
+        初始化登录错误异常。
+
+        Args:
+            code (int): 错误代码。
+            message (str): 错误消息。
+        """
         self.code = code
         self.message = message
         super().__init__(f'Error code: {code}, message: {message}')
 
 
 class mijiaLogin(object):
-    def __init__(self, save_auth=True, save_path='jsons/auth.json'):
+    def __init__(self, save_path: Optional[str] = None):
+        """
+        初始化米家登录对象。
+
+        Args:
+            save_path (str, optional): 认证数据保存路径。默认为None。
+        """
         self.auth_data = None
-        self.save_auth = save_auth
         self.save_path = save_path
 
         self.deviceId = ''.join(random.sample(string.digits + string.ascii_letters, 16))
@@ -39,6 +51,15 @@ class mijiaLogin(object):
         })
 
     def _get_index(self) -> dict[str, str]:
+        """
+        获取索引页数据。
+
+        Returns:
+            dict[str, str]: 包含设备ID和其他必要参数的字典。
+
+        Raises:
+            LoginError: 请求索引页失败时抛出。
+        """
         ret = self.session.get(msgURL)
         if ret.status_code != 200:
             raise LoginError(ret.status_code, f'Failed to get index page, {ret.text}')
@@ -51,6 +72,18 @@ class mijiaLogin(object):
         return data
 
     def _get_account(self, user_id: str) -> dict[str, str]:
+        """
+        获取账户信息。
+
+        Args:
+            user_id (str): 用户ID。
+
+        Returns:
+            dict[str, str]: 包含账户信息的字典。
+
+        Raises:
+            LoginError: 获取账户信息失败时抛出。
+        """
         ret = self.session.get(accountURL + str(user_id))
         if ret.status_code != 200:
             raise LoginError(ret.status_code, f'Failed to get account page, {ret.text}')
@@ -62,9 +95,18 @@ class mijiaLogin(object):
         return data
 
     def _save_auth(self) -> None:
-        if self.save_auth and self.auth_data is not None:
+        """
+        保存认证数据到文件。
+
+        如果设置了保存路径且有认证数据，则将其以JSON格式保存到指定路径。
+        """
+        if self.save_path is not None and self.auth_data is not None:
             if not os.path.isabs(self.save_path):
                 self.save_path = os.path.abspath(self.save_path)
+            if os.path.exists(self.save_path) and not os.path.isfile(self.save_path):
+                raise ValueError(f'Path [{self.save_path}] is not a file')
+            if not os.path.exists(os.path.dirname(self.save_path)):
+                os.makedirs(os.path.dirname(self.save_path))
             with open(self.save_path, 'w') as f:
                 json.dump(self.auth_data, f, indent=2)
             logger.info(f'Auth data saved to [{self.save_path}]')
@@ -72,15 +114,18 @@ class mijiaLogin(object):
             logger.info('Auth data not saved')
 
     def login(self, username: str, password: str) -> dict:
-        """login with username and password
-        mijiaLogin.login(username: str, password: str) -> dict
-        -------
-        @param
-        username: str, xiaomi account username(email/phone number/xiaomi id)
-        password: str, xiaomi account password
-        -------
-        @return
-        dict, data for authorization, including userId, ssecurity, deviceId, serviceToken
+        """
+        使用用户名和密码登录。
+
+        Args:
+            username (str): 小米账户用户名（邮箱/手机号/小米ID）。
+            password (str): 小米账户密码。
+
+        Returns:
+            dict: 授权数据，包含userId、ssecurity、deviceId和serviceToken。
+
+        Raises:
+            LoginError: 登录失败时抛出。
         """
         logger.warning('There is a high probability of verification code with account and password. Please try other login methods')
         data = self._get_index()
@@ -116,12 +161,18 @@ class mijiaLogin(object):
         self.auth_data = auth_data
         self.auth_data.update(self._get_account(auth_data['userId']))
 
-        if self.save_auth:
-            self._save_auth()
+        self._save_auth()
         return auth_data
 
     @staticmethod
     def _print_qr(loginurl: str, box_size: int = 10) -> None:
+        """
+        打印并保存二维码。
+
+        Args:
+            loginurl (str): 包含登录信息的URL。
+            box_size (int, optional): 二维码大小。默认为10。
+        """
         logger.info('Scan the QR code below with Mi Home app')
         qr = QRCode(border=1, box_size=box_size)
         qr.add_data(loginurl)
@@ -136,11 +187,14 @@ class mijiaLogin(object):
                         'Or just use the qr.png file in the current directory.')
 
     def QRlogin(self) -> dict:
-        """login with QR code
-        mijiaLogin.QRlogin() -> dict
-        -------
-        @return
-        dict, data for authorization, including userId, ssecurity, deviceId, serviceToken
+        """
+        使用二维码登录。
+
+        Returns:
+            dict: 授权数据，包含userId、ssecurity、deviceId和serviceToken。
+
+        Raises:
+            LoginError: 登录失败时抛出。
         """
         data = self._get_index()
         location = data['location']
@@ -191,10 +245,12 @@ class mijiaLogin(object):
         self.auth_data = auth_data
         self.auth_data.update(self._get_account(auth_data['userId']))
 
-        if self.save_auth:
-            self._save_auth()
+        self._save_auth()
         return auth_data
 
     def __del__(self):
+        """
+        析构函数，清理生成的二维码文件。
+        """
         if os.path.exists('qr.png'):
             os.remove('qr.png')

{mijiaapi-1.3.10 → mijiaapi-1.3.12}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mijiaAPI"
-version = "1.3.10"
+version = "1.3.12"
 description = "A Python API for Xiaomi Mijia"
 readme = "README.md"
 requires-python = ">=3.9,<4.0"
@@ -12,7 +12,7 @@ dependencies = [
 
 [tool.poetry]
 name = "mijiaAPI"
-version = "1.3.10"
+version = "1.3.12"
 description = "A Python API for Xiaomi Mijia"
 authors = ["Do1e <dpj.email@qq.com>"]
 license = "GPLv3"

mijiaapi-1.3.10/mijiaAPI/apis.py

@@ -1,171 +0,0 @@
-from typing import Union
-import requests
-import requests.cookies
-
-from .code import ERROR_CODE
-from .utils import defaultUA, post_data, PostDataError
-
-
-class mijiaAPI(object):
-    def __init__(self, auth_data: dict):
-        if any(k not in auth_data for k in ['userId', 'deviceId', 'ssecurity', 'serviceToken']):
-            raise Exception('Invalid authorize data')
-        self.userId = auth_data['userId']
-        self.ssecurity = auth_data['ssecurity']
-        self.session = requests.Session()
-        self.session.headers.update({
-            'User-Agent': defaultUA,
-            'x-xiaomi-protocal-flag-cli': 'PROTOCAL-HTTP2',
-            'Cookie': f'PassportDeviceId={auth_data["deviceId"]};'
-                      f'userId={auth_data["userId"]};'
-                      f'serviceToken={auth_data["serviceToken"]};',
-        })
-
-    @staticmethod
-    def _post_process(data: dict) -> Union[list, bool]:
-        if data['code'] != 0:
-            raise Exception(f'Failed to get data, {data["message"]}')
-        return data['result']
-
-    @property
-    def available(self) -> bool:
-        """check if the API is available"""
-        uri = '/home/device_list'
-        data = {"getVirtualModel": False, "getHuamiDevices": 0}
-        try:
-            post_data(self.session, self.ssecurity, uri, data)
-            return True
-        except PostDataError:
-            return False
-
-    def get_devices_list(self) -> dict:
-        """get devices list
-        mijiaAPI.get_devices_list() -> dict
-        -------
-        @return
-        dict, devices list
-        """
-        uri = '/home/device_list'
-        data = {"getVirtualModel": False, "getHuamiDevices": 0}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
-
-    def get_homes_list(self) -> list:
-        """get homes list
-        mijiaAPI.get_homes_list() -> list
-        -------
-        @return
-        list, homes list, including rooms
-        """
-        uri = '/v2/homeroom/gethome'
-        data = {"fg": False, "fetch_share": True, "fetch_share_dev": True, "limit": 300, "app_ver": 7}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
-
-    def get_scenes_list(self, home_id: str) -> list:
-        """get scenes list
-        set it in Mi Home APP -> Add -> Manual controls
-        mijiaAPI.get_scenes_list(home_id: str) -> list
-        -------
-        @param
-        home_id: str, room id, get from get_homes_list
-        -------
-        @return
-        list, scenes list
-        """
-        uri = '/appgateway/miot/appsceneservice/AppSceneService/GetSceneList'
-        data = {"home_id": home_id}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
-
-    def run_scene(self, scene_id: str) -> bool:
-        """run scene
-        mijiaAPI.run_scene(scene_id: str) -> bool
-        -------
-        @param
-        scene_id: str, scene id, get from get_scenes_list
-        -------
-        @return
-        dict, result
-        """
-        uri = '/appgateway/miot/appsceneservice/AppSceneService/RunScene'
-        data = {"scene_id": scene_id, "trigger_key": "user.click"}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
-
-    def get_consumable_items(self, home_id: str) -> list:
-        """get consumable items
-        mijiaAPI.get_consumable_items(did: str) -> list
-        -------
-        @param
-        home_id: str, room id, get from get_homes_list
-        -------
-        @return
-        list, consumable items
-        """
-        uri = '/v2/home/standard_consumable_items'
-        data = {"home_id": int(home_id), "owner_id": self.userId}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
-
-    def get_devices_prop(self, data: list) -> list:
-        """get devices properties
-        mijiaAPI.get_devices_prop(data: list) -> list
-        -------
-        @param
-        data: list of dict
-            dict keys:
-                - did: str, device id, get from get_devices_list
-                - siid: str, service id, get from https://home.miot-spec.com/spec/{model}, model from get_devices_list
-                - piid: str, property id, get from https://home.miot-spec.com/spec/{model}, model from get_devices_list
-            model yeelink.light.lamp4 as an example:
-            [
-                {"did": "1234567890", "siid": 2, "piid": 2}, # get the brightness
-                {"did": "1234567890", "siid": 2, "piid": 3}, # get the color temperature
-            ]
-        -------
-        @return
-        list, device properties
-        """
-        uri = '/miotspec/prop/get'
-        data = {"params": data}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
-
-    def set_devices_prop(self, data: list) -> list:
-        """set devices properties
-        mijiaAPI.set_devices_prop(data: list) -> list
-        -------
-        @param
-        data: list of dict
-            dict keys:
-                - did: str, device id, get from get_devices_list
-                - siid: str, service id, get from https://home.miot-spec.com/spec/{model}, model from get_devices_list
-                - piid: str, property id, get from https://home.miot-spec.com/spec/{model}, model from get_devices_list
-                - value: str, value to set
-            model yeelink.light.lamp4 as an example:
-            [
-                {"did": "1234567890", "siid": 2, "piid": 2, "value": 50} # set the brightness to 50%
-                {"did": "1234567890", "siid": 2, "piid": 3, "value": 2700} # set the color temperature to 2700K
-            ]
-        -------
-        @return
-        dict, result
-        """
-        uri = '/miotspec/prop/set'
-        data = {"params": data}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
-
-    def run_action(self, data: dict) -> dict:
-        """run action
-        mijiaAPI.run_action(data: dict) -> dict
-        @param
-        data: dict
-            dict keys:
-                - did: str, device id, get from get_devices_list
-                - siid: str, service id, get from https://home.miot-spec.com/spec/{model}, model from get_devices_list
-                - aiid: str, action id, get from https://home.miot-spec.com/spec/{model}, model from get_devices_list
-                - value: list, value to list
-            model xiaomi.feeder.pi2001 as an example:
-            {"did": "1234567890", "siid": 2, "aiid": 1, "value": [2]}, # Remote feeding (2 servings) of food
-        -------
-        @return
-        dict, result
-        """
-        uri = '/miotspec/action'
-        data = {"params": data}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))