megalion-http 0.0.1__tar.gz

megalion_http-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Klara Modin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

megalion_http-0.0.1/PKG-INFO

@@ -0,0 +1,17 @@
+Metadata-Version: 2.5
+Name: megalion-http
+Version: 0.0.1
+Summary: Expose the Megalion HTTP API to python
+Project-URL: Homepage, https://github.com/klarasm/megalion-http
+Project-URL: Issues, https://github.com/klarasm/megalion-http/issues
+Author-email: Klara Modin <klarasmodin@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# Megalion-HTTP
+
+This exposes the Megalion HTTP API to python, for use with HomeAssistant.

megalion_http-0.0.1/README.md

@@ -0,0 +1,3 @@
+# Megalion-HTTP
+
+This exposes the Megalion HTTP API to python, for use with HomeAssistant.

megalion_http-0.0.1/build/lib/megalion-http/auth.py

@@ -0,0 +1,23 @@
+from aiohttp import ClientResponse, ClientSession
+
+class Auth:
+    """Make authenticated requests to the API."""
+
+    def __init__(
+            self, session: ClientSession, host: str, access_token: str
+            ) -> None:
+        """Initialize the auth."""
+        self.session = session
+        self.host = host
+        self.access_token = access_token
+
+    async def request(
+            self, method: str, path: str, **kwargs
+            ) -> ClientResponse:
+        """Make a request."""
+        headers = dict(kwargs.pop("headers", None) or {})
+        headers["authorization"] = f"Bearer {self.access_token}"
+
+        return await self.session.request(
+                method, f"{self.host}/{path}", **kwargs, headers=headers
+                )

megalion_http-0.0.1/build/lib/megalion-http/battery.py

@@ -0,0 +1,146 @@
+from typing import Any
+
+from .auth import Auth
+
+class Battery:
+    """A Megalion Battery (ESS)"""
+
+    def __init__(self, sn: str, auth: Auth) -> None:
+        """Initialize the battery"""
+        self.device_sn = sn
+        self.auth = auth
+
+    async def async_update(self) -> None:
+        response = await self.auth.request("get", f"system/stationDevice/list?sn={self.device_sn}")
+        response.raise_for_status()
+        raw_data = await response.json()
+        self.raw_data = raw_data['rows'][0]
+        response = await self.auth.request("get", f"system/deviceLatestData/getLatestDataTable?sn={self.device_sn}")
+        response.raise_for_status()
+        raw_detail = await response.json()
+        self.raw_detail = raw_detail['data']
+        response = await self.auth.request("get", f"system/deviceLatestData/getCellVoltages?sn={self.device_sn}")
+        response.raise_for_status()
+        raw_voltages = await response.json()
+        self.raw_voltages = raw_voltages['data']
+
+    @property
+    def batchName(self) -> str:
+        return self.raw_data['batchName']
+
+    @property
+    def batteryRatedEnergy(self) -> float:
+        return self.raw_data['batteryRatedEnergy']
+
+    @property
+    def batteryTemperature(self) -> float:
+        return self.raw_data['batteryTemperature']
+
+    @property
+    def chargeStatus(self) -> str:
+        return self.raw_data['chargeStatus']
+
+    @property
+    def createBy(self) -> str:
+        return self.raw_data['createBy']
+
+    @property
+    def createTime(self) -> str:
+        return self.raw_data['createTime']
+
+    @property
+    def createTimeTimezone(self) -> str:
+        return self.raw_data['createTimeTimezone']
+
+    @property
+    def current(self) -> float:
+        return self.raw_data['current']
+
+    @property
+    def dayCharge(self) -> float:
+        return self.raw_data['dayCharge']
+
+    @property
+    def dayDischarge(self) -> float:
+        return self.raw_data['dayDischarge']
+
+    @property
+    def deviceId(self) -> int:
+        return self.raw_data['deviceId']
+
+    @property
+    def deviceModel(self) -> str:
+        return self.raw_data['deviceModel']
+
+    @property
+    def deviceName(self) -> str:
+        return self.raw_data['deviceName']
+
+    @property
+    def deviceStatus(self) -> str:
+        return self.raw_data['deviceStatus']
+
+    @property
+    def deviceType(self) -> str:
+        return self.raw_data['deviceType']
+
+    @property
+    def deviceTypeStr(self) -> str:
+        return self.raw_data['deviceTypeStr']
+
+    @property
+    def dynamicLinkedDeviceSn(self) -> str:
+        return self.raw_data['dynamicLinkedDeviceSn']
+
+    @property
+    def inverterBrand(self) -> str:
+        return self.raw_data['inverterBrand']
+
+    @property
+    def lastOfflineTimeUtc(self) -> str:
+        return self.raw_data['lastOfflineTimeUtc']
+
+    @property
+    def lastOnlineTimeUtc(self) -> str:
+        return self.raw_data['lastOnlineTimeUtc']
+
+    @property
+    def realtimePower(self) -> float:
+        return self.raw_data['realtimePower']
+
+    @property
+    def sn(self) -> str:
+        return self.raw_data['sn']
+
+    @property
+    def soc(self) -> float:
+        return self.raw_data['soc']
+
+    @property
+    def staticLinkedDeviceSn(self) -> str:
+        return self.raw_data['staticLinkedDeviceSn']
+
+    @property
+    def stations(self) -> dict[str, Any]:
+        return self.raw_data['stations']
+
+    @property
+    def totalCharge(self) -> float:
+        return self.raw_data['totalCharge']
+
+    @property
+    def totalDischarge(self) -> float:
+        return self.raw_data['totalDischarge']
+
+    @property
+    def userId(self) -> str:
+        return self.raw_data['userId']
+
+    @property
+    def voltage(self) -> float:
+        return self.raw_data['voltage']
+
+    @property
+    def cellVoltages(self) -> list[int]:
+        return self.raw_voltages['cellVoltages']
+

megalion_http-0.0.1/build/lib/megalion-http/megalion.py

@@ -0,0 +1,20 @@
+from .auth import Auth
+from .battery import Battery
+
+class MegalionHubAPI:
+    def __init__(self, auth: Auth) -> None:
+        self.auth = auth
+
+    async def async_get_batteries(self) -> list[Battery]:
+        response = await self.auth.request("get", f"system/stationDevice/list")
+        response.raise_for_status()
+        raw_data = await response.json()
+        if raw_data['code'] != 200:
+            raise MegalionHubError
+        batteries = []
+        for device in raw_data['rows']:
+            if device['deviceType'] == "ENERGY_STORAGE_EQUIPMENT":
+                battery = Battery(device['sn'], self.auth)
+                batteries.append(battery)
+                await battery.async_update()
+        return batteries

megalion_http-0.0.1/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "megalion-http"
+version = "0.0.1"
+authors = [
+  { name="Klara Modin", email="klarasmodin@gmail.com" },
+]
+description = "Expose the Megalion HTTP API to python"
+readme = "README.md"
+requires-python = ">=3.14"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+
+[project.urls]
+Homepage = "https://github.com/klarasm/megalion-http"
+Issues = "https://github.com/klarasm/megalion-http/issues"
+
+[build-system]
+requires = ["hatchling >= 1.26"]
+build-backend = "hatchling.build"

megalion_http-0.0.1/requirements.txt

@@ -0,0 +1 @@
+aiohttp==3.14.5

megalion_http-0.0.1/src/megalion_http/__init__.py

@@ -0,0 +1 @@
+from .megalion import *

megalion_http-0.0.1/src/megalion_http/auth.py

@@ -0,0 +1,36 @@
+from aiohttp import ClientResponse, ClientSession
+
+class Auth:
+    """Make authenticated requests to the API."""
+
+    def __init__(self, session: ClientSession, host: str,
+                 access_token: str) -> None:
+        """Initialize the auth."""
+        self.session = session
+        self.host = host
+        self.access_token = access_token
+
+    async def update_token(self, username: str, password: str) -> None:
+        response = await self.session.request("post",
+                                              f"https://{self.host}/auth/login",
+                                              json={'username': username,
+                                                    'password': password})
+        response.raise_for_status()
+        data = await response.json()
+        if (data['code'] != 200):
+            raise AuthError(str(data))
+        self.access_token = data['data']['access_token']
+
+    async def request(
+            self, method: str, path: str, **kwargs
+            ) -> ClientResponse:
+        """Make a request."""
+        headers = dict(kwargs.pop("headers", None) or {})
+        headers["authorization"] = f"Bearer {self.access_token}"
+
+        return await self.session.request(
+                method, f"https://{self.host}/{path}", **kwargs, headers=headers
+                )
+
+class AuthError(Exception):
+    pass

megalion_http-0.0.1/src/megalion_http/battery.py

@@ -0,0 +1,149 @@
+from typing import Any
+
+from .auth import Auth
+
+class Battery:
+    """A Megalion Battery (ESS)"""
+
+    def __init__(self, sn: str, auth: Auth) -> None:
+        """Initialize the battery"""
+        self.device_sn = sn
+        self.auth = auth
+
+    async def async_update(self) -> None:
+        response = await self.auth.request("get", f"system/stationDevice/list?sn={self.device_sn}")
+        response.raise_for_status()
+        raw_data = await response.json()
+        self.raw_data = raw_data['rows'][0]
+        response = await self.auth.request("get", f"system/deviceLatestData/getLatestDataTable?sn={self.device_sn}")
+        response.raise_for_status()
+        raw_detail = await response.json()
+        self.raw_detail = raw_detail['data']
+        response = await self.auth.request("get", f"system/deviceLatestData/getCellVoltages?sn={self.device_sn}")
+        response.raise_for_status()
+        raw_voltages = await response.json()
+        self.raw_voltages = raw_voltages['data']
+        response = await self.auth.request("get", f"system/deviceLatestData/getCellTemperatures?sn={self.device_sn}")
+        response.raise_for_status()
+        raw_temperatures = await response.json()
+        self.raw_temperatures = raw_temperatures['data']
+
+    @property
+    def batchName(self) -> str:
+        return self.raw_data['batchName']
+
+    @property
+    def batteryRatedEnergy(self) -> float:
+        return self.raw_data['batteryRatedEnergy']
+
+    @property
+    def batteryTemperature(self) -> float:
+        return self.raw_data['batteryTemperature']
+
+    @property
+    def chargeStatus(self) -> str:
+        return self.raw_data['chargeStatus']
+
+    @property
+    def createBy(self) -> str:
+        return self.raw_data['createBy']
+
+    @property
+    def createTime(self) -> str:
+        return self.raw_data['createTime']
+
+    @property
+    def createTimeTimezone(self) -> str:
+        return self.raw_data['createTimeTimezone']
+
+    @property
+    def current(self) -> float:
+        return self.raw_data['current']
+
+    @property
+    def dayCharge(self) -> float:
+        return self.raw_data['dayCharge']
+
+    @property
+    def dayDischarge(self) -> float:
+        return self.raw_data['dayDischarge']
+
+    @property
+    def deviceId(self) -> int:
+        return self.raw_data['deviceId']
+
+    @property
+    def deviceModel(self) -> str:
+        return self.raw_data['deviceModel']
+
+    @property
+    def deviceName(self) -> str:
+        return self.raw_data['deviceName']
+
+    @property
+    def deviceStatus(self) -> str:
+        return self.raw_data['deviceStatus']
+
+    @property
+    def deviceType(self) -> str:
+        return self.raw_data['deviceType']
+
+    @property
+    def deviceTypeStr(self) -> str:
+        return self.raw_data['deviceTypeStr']
+
+    @property
+    def dynamicLinkedDeviceSn(self) -> str:
+        return self.raw_data['dynamicLinkedDeviceSn']
+
+    @property
+    def inverterBrand(self) -> str:
+        return self.raw_data['inverterBrand']
+
+    @property
+    def lastOfflineTimeUtc(self) -> str:
+        return self.raw_data['lastOfflineTimeUtc']
+
+    @property
+    def lastOnlineTimeUtc(self) -> str:
+        return self.raw_data['lastOnlineTimeUtc']
+
+    @property
+    def realtimePower(self) -> float:
+        return self.raw_data['realtimePower']
+
+    @property
+    def sn(self) -> str:
+        return self.raw_data['sn']
+
+    @property
+    def soc(self) -> float:
+        return self.raw_data['soc']
+
+    @property
+    def staticLinkedDeviceSn(self) -> str:
+        return self.raw_data['staticLinkedDeviceSn']
+
+    @property
+    def totalCharge(self) -> float:
+        return self.raw_data['totalCharge']
+
+    @property
+    def totalDischarge(self) -> float:
+        return self.raw_data['totalDischarge']
+
+    @property
+    def userId(self) -> str:
+        return self.raw_data['userId']
+
+    @property
+    def voltage(self) -> float:
+        return self.raw_data['voltage']
+
+    @property
+    def cellVoltages(self) -> list[int]:
+        return self.raw_voltages['cellVoltages']
+
+    @property
+    def cellTemperatures(self) -> list[int]:
+        return self.raw_temperatures['cellTemperatures']

megalion_http-0.0.1/src/megalion_http/megalion.py

@@ -0,0 +1,29 @@
+from .auth import Auth, AuthError
+from .battery import Battery
+from .user import User
+
+class MegalionHubAPI:
+    def __init__(self, auth: Auth) -> None:
+        self.auth = auth
+
+    async def async_get_user(self) -> User:
+        user = User(self.auth)
+        await user.async_update()
+        return user
+
+    async def async_get_batteries(self) -> list[Battery]:
+        response = await self.auth.request("get", f"system/stationDevice/list")
+        response.raise_for_status()
+        raw_data = await response.json()
+        if raw_data['code'] != 200:
+            raise MegalionHubError(str(raw_data))
+        batteries = []
+        for device in raw_data['rows']:
+            if device['deviceType'] == "ENERGY_STORAGE_EQUIPMENT":
+                battery = Battery(device['sn'], self.auth)
+                batteries.append(battery)
+                await battery.async_update()
+        return batteries
+
+class MegalionHubError(Exception):
+    pass

megalion_http-0.0.1/src/megalion_http/user.py

@@ -0,0 +1,27 @@
+from typing import Any
+
+from .auth import Auth
+
+class User:
+    """A Megalion API User"""
+
+    def __init__(self, auth: Auth) -> None:
+        """Initialize the battery"""
+        self.auth = auth
+
+    async def async_update(self) -> None:
+        response = await self.auth.request("get", f"system/user/getInfo")
+        response.raise_for_status()
+        self.raw_data = await response.json()
+
+    @property
+    def userId(self) -> int:
+        return self.raw_data['user']['userId']
+
+    @property
+    def email(self) -> str:
+        return self.raw_data['user']['email']
+
+    @property
+    def userName(self) -> str:
+        return self.raw_data['user']['userName']

megalion_http-0.0.1/src/megalion_http.egg-info/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: megalion-http
+Version: 0.0.1
+Summary: Expose the Megalion HTTP API to python
+Author-email: Klara Modin <klarasmodin@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/klarasm/megalion-http
+Project-URL: Issues, https://github.com/klarasm/megalion-http/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Megalion-HTTP
+
+This exposes the Megalion HTTP API to python, for use with HomeAssistant.

megalion_http-0.0.1/src/megalion_http.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/megalion-http/__init__.py
+src/megalion-http/auth.py
+src/megalion-http/battery.py
+src/megalion-http/megalion.py
+src/megalion_http.egg-info/PKG-INFO
+src/megalion_http.egg-info/SOURCES.txt
+src/megalion_http.egg-info/dependency_links.txt
+src/megalion_http.egg-info/top_level.txt

megalion_http-0.0.1/src/megalion_http.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

megalion_http-0.0.1/src/megalion_http.egg-info/top_level.txt

@@ -0,0 +1 @@
+megalion-http

megalion_http-0.0.1/test.py

@@ -0,0 +1,22 @@
+#!/usr/bin/python3
+import asyncio
+
+import aiohttp
+
+from megalion_http import MegalionHubAPI
+from megalion_http import Battery
+from megalion_http import Auth
+
+async def main() -> None:
+    async with aiohttp.ClientSession() as session:
+        # auth = Auth(session, "https://server.zh.megalion.cn/", "eyJhbGciOiJIUzUxMiJ9.eyJ1c2VyX2lkIjoyNjksInVzZXJfa2V5IjoiNjNlYWE4ODMtMjAwNy00OWVlLTk1MTMtNDk5YWUwZjE5NDAxIiwidXNlcm5hbWUiOiJrbGFyYSJ9.evLT0eGsPinTchgDEzP-MYME4JpmadDG0tYLQHiYbVG6nfrlHZLwH7aUyF-BMVpec8Iw9aP1X2019THGzGUJ_A")
+        auth = Auth(session, "server.zh.megalion.cn", "")
+        await auth.update_token("klarasmodin@gmail.com", "ahQBU3rBXPqOiXrKgnPt")
+
+        hub = MegalionHubAPI(auth)
+        batteries = await hub.async_get_batteries()
+        for battery in batteries:
+            print(battery.cellVoltages)
+            print(battery.cellTemperatures)
+
+asyncio.run(main())