mijiaAPI 1.3.4__tar.gz → 1.3.6__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- mijiaapi-1.3.6/PKG-INFO +98 -0
- mijiaapi-1.3.6/README.md +73 -0
- {mijiaapi-1.3.4 → mijiaapi-1.3.6}/mijiaAPI/devices.py +1 -1
- {mijiaapi-1.3.4 → mijiaapi-1.3.6}/mijiaAPI/login.py +163 -155
- {mijiaapi-1.3.4 → mijiaapi-1.3.6}/pyproject.toml +13 -1
- mijiaapi-1.3.4/PKG-INFO +0 -76
- mijiaapi-1.3.4/README.md +0 -51
- {mijiaapi-1.3.4 → mijiaapi-1.3.6}/LICENSE +0 -0
- {mijiaapi-1.3.4 → mijiaapi-1.3.6}/mijiaAPI/__init__.py +0 -0
- {mijiaapi-1.3.4 → mijiaapi-1.3.6}/mijiaAPI/apis.py +0 -0
- {mijiaapi-1.3.4 → mijiaapi-1.3.6}/mijiaAPI/urls.py +0 -0
- {mijiaapi-1.3.4 → mijiaapi-1.3.6}/mijiaAPI/utils.py +0 -0
mijiaapi-1.3.6/PKG-INFO
ADDED
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: mijiaAPI
|
|
3
|
+
Version: 1.3.6
|
|
4
|
+
Summary: A Python API for Xiaomi Mijia
|
|
5
|
+
Home-page: https://github.com/Do1e/mijia-api
|
|
6
|
+
License: GPLv3
|
|
7
|
+
Author: Do1e
|
|
8
|
+
Author-email: dpj.email@qq.com
|
|
9
|
+
Requires-Python: >=3.9,<4.0
|
|
10
|
+
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
|
|
11
|
+
Classifier: License :: Other/Proprietary License
|
|
12
|
+
Classifier: Operating System :: OS Independent
|
|
13
|
+
Classifier: Programming Language :: Python :: 3
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
19
|
+
Requires-Dist: pillow (>=11.0.0,<12.0.0)
|
|
20
|
+
Requires-Dist: qrcode (>=8.0,<9.0)
|
|
21
|
+
Requires-Dist: requests (>=2.32.3,<3.0.0)
|
|
22
|
+
Project-URL: Repository, https://github.com/Do1e/mijia-api
|
|
23
|
+
Description-Content-Type: text/markdown
|
|
24
|
+
|
|
25
|
+
# mijiaAPI
|
|
26
|
+
小米米家设备的api,可以使用代码直接控制米家设备的功能,[Github link](https://github.com/Do1e/mijia-api),[PyPI link](https://pypi.org/project/mijiaAPI/)。
|
|
27
|
+
|
|
28
|
+
## 安装
|
|
29
|
+
```bash
|
|
30
|
+
poetry install
|
|
31
|
+
```
|
|
32
|
+
或者
|
|
33
|
+
```bash
|
|
34
|
+
pip install mijiaAPI
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## 使用
|
|
38
|
+
使用实例可以参考`demos`文件夹下的示例代码,以下是简单的使用说明
|
|
39
|
+
|
|
40
|
+
### 登录
|
|
41
|
+
|
|
42
|
+
`mijiaLogin`:登录小米账号,获取控制设备必须的`userId`, `ssecurity`, `deviceId`, `serviceToken`,方法列表:
|
|
43
|
+
* `login(username: str, password: str) -> dict`:账号密码登录,返回上述信息。**注意,目前这一方法大概率遇到手机验证码,请尽可能使用`QRlogin`。**
|
|
44
|
+
* `QRlogin() -> dict`:扫描二维码登录,返回上述信息(会在支持tty的终端打印二维码,若打印识别可查看当前文件夹下的`qr.png`)
|
|
45
|
+
|
|
46
|
+
**手动登录方法**
|
|
47
|
+
|
|
48
|
+
可以使用浏览器,手动获取`userId`, `ssecurity`, `deviceId`, `serviceToken`。当然我还是更推荐大家使用扫码登录,但大家也可以根据下述步骤了解如何获取这些信息。
|
|
49
|
+
|
|
50
|
+
打开浏览器访问 https://account.xiaomi.com/pass/serviceLogin?sid=xiaomiio&_json=true ,会得到下述信息,复制location中的url到新的界面打开:
|
|
51
|
+
|
|
52
|
+
```text
|
|
53
|
+
&&&START&&&{"serviceParam":"{\"checkSafePhone\":false,\"checkSafeAddress\":false,\"lsrp_score\":0.0}","qs":"%3Fsid%3Dxiaomiio%26_json%3Dtrue","code":70016,"description":"登录验证失败","securityStatus":0,"_sign":"0psXfr43eNI0IX6q9Suk3qWbRqU=","sid":"xiaomiio","result":"error","captchaUrl":null,"callback":"https://sts.api.io.mi.com/sts","location":"https://account.xiaomi.com/fe/service/login?_json=true&sid=xiaomiio&qs=%253Fsid%253Dxiaomiio%2526_json%253Dtrue&callback=.........","pwd":0,"child":0,"desc":"登录验证失败"}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
打开后会进入小米的登录界面(如果直接显示了`ok`,是因为保存了之前的cookie,建议使用无痕窗口重新开始上述步骤),此时需要先按下 `F12` 打开开发者工具,切换到`Network`选项卡,之后可以输入账号密码或者扫码登录。完成后页面会显示一个`ok`。
|
|
57
|
+
|
|
58
|
+
此时在网络选项卡中按下`Ctrl+F`,搜索上述所需的`userId`, `ssecurity`, `deviceId`, `serviceToken`即可。
|
|
59
|
+
|
|
60
|
+
或者筛选请求:
|
|
61
|
+
1. `https://sts.api.io.mi.com/sts`,其中的`set-cookie`中包含`userId`和`serviceToken`(`=`到`;`前止)。
|
|
62
|
+
2. `https://account.xiaomi.com/pass/serviceLoginAuth2/end`,其中的`extension-pragma`中包含`ssecurity`(`:"`到`"`前止)。
|
|
63
|
+
3. `https://account.xiaomi.com/identity/authStart`,其中的`cookie`中包含`deviceId`(`=`到`;`前止)。
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
### API
|
|
67
|
+
|
|
68
|
+
`mijiaAPI`:API的实现,使用`mijiaLogin`登录后返回的信息进行初始化
|
|
69
|
+
* `__init__(auth_data: dict)`:初始化
|
|
70
|
+
* `available -> bool`:传入的`auth_data`是否有效
|
|
71
|
+
* `get_devices_list() -> list`:获取设备列表
|
|
72
|
+
* `get_homes_list() -> list`:获取家庭列表,家庭字典中包含房间列表
|
|
73
|
+
* `get_scenes_list(home_id: str) -> list`:获取手动场景列表,在 *米家->添加->手动控制* 中设置
|
|
74
|
+
* `run_scene(scene_id: str) -> bool`:运行手动场景
|
|
75
|
+
* `get_consumable_items(home_id: str) -> list`:获取设备的耗材信息
|
|
76
|
+
* `get_devices_prop(data: list) -> list`:获取设备的属性
|
|
77
|
+
* `set_devices_prop(data: list) -> list`:设置设备的属性
|
|
78
|
+
* `data`为一个字典的列表,字典需要包含`did`, `siid`, `piid`,后面两个键可从 *https://home.miot-spec.com/spec/{model}* 中获取,其中`model`为设备的model,在设备列表中获取,如[米家台灯 1S](https://home.miot-spec.com/spec/yeelink.light.lamp4)。
|
|
79
|
+
* 网站上的方法并非全部可用,需要自行测试
|
|
80
|
+
* `run_action(data: dict) -> dict`:执行设备的action
|
|
81
|
+
* `data`为一个字典,需要包含`did`, `siid`, `aiid`,获取方法同上
|
|
82
|
+
|
|
83
|
+
### 针对设备的封装
|
|
84
|
+
|
|
85
|
+
`mijiaDevices`:使用`mijiaAPI`和设备属性字典初始化,以便更方便地调用设备属性
|
|
86
|
+
* `__init__(api: mijiaAPI, dev_info: dict. did: str = None, sleep_time: float = 0.5)`:初始化,`dev_info`为设备属性,参考[demos/dev_info_example](demos/dev_info_example),`sleep_time`为每次调用设备属性的间隔时间(注:设置属性后立刻获取属性会不符合预期,需要延迟一段时间)
|
|
87
|
+
* `set(name: str, did: str, value: Union[bool, int]) -> Union[bool, int]`:设置设备属性
|
|
88
|
+
* `get(name: str, did: str) -> Union[bool, int]`:获取设备属性
|
|
89
|
+
* v1.2.0 新增直接通过名称设置/获取属性,需要在初始化时传入`did`,详见[demos/test_devices_v2_light.py](demos/test_devices_v2_light.py)。名称中包含`-`的属性需要替换为`_`。
|
|
90
|
+
* 可以调用`get_device_info(device_model: str) -> dict`函数从[米家设备列表](https://home.miot-spec.com/)在线获取设备属性字典,详见[demos/test_get_device_info.py](demos/test_get_device_info.py)
|
|
91
|
+
|
|
92
|
+
## 致谢
|
|
93
|
+
* [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)
|
|
94
|
+
|
|
95
|
+
## 声明
|
|
96
|
+
* 本项目仅供学习交流使用,不得用于商业用途,如有侵权请联系删除。
|
|
97
|
+
* 本项目作者不对使用本项目产生的任何后果负责,请用户自行承担使用本项目的风险。
|
|
98
|
+
|
mijiaapi-1.3.6/README.md
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# mijiaAPI
|
|
2
|
+
小米米家设备的api,可以使用代码直接控制米家设备的功能,[Github link](https://github.com/Do1e/mijia-api),[PyPI link](https://pypi.org/project/mijiaAPI/)。
|
|
3
|
+
|
|
4
|
+
## 安装
|
|
5
|
+
```bash
|
|
6
|
+
poetry install
|
|
7
|
+
```
|
|
8
|
+
或者
|
|
9
|
+
```bash
|
|
10
|
+
pip install mijiaAPI
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## 使用
|
|
14
|
+
使用实例可以参考`demos`文件夹下的示例代码,以下是简单的使用说明
|
|
15
|
+
|
|
16
|
+
### 登录
|
|
17
|
+
|
|
18
|
+
`mijiaLogin`:登录小米账号,获取控制设备必须的`userId`, `ssecurity`, `deviceId`, `serviceToken`,方法列表:
|
|
19
|
+
* `login(username: str, password: str) -> dict`:账号密码登录,返回上述信息。**注意,目前这一方法大概率遇到手机验证码,请尽可能使用`QRlogin`。**
|
|
20
|
+
* `QRlogin() -> dict`:扫描二维码登录,返回上述信息(会在支持tty的终端打印二维码,若打印识别可查看当前文件夹下的`qr.png`)
|
|
21
|
+
|
|
22
|
+
**手动登录方法**
|
|
23
|
+
|
|
24
|
+
可以使用浏览器,手动获取`userId`, `ssecurity`, `deviceId`, `serviceToken`。当然我还是更推荐大家使用扫码登录,但大家也可以根据下述步骤了解如何获取这些信息。
|
|
25
|
+
|
|
26
|
+
打开浏览器访问 https://account.xiaomi.com/pass/serviceLogin?sid=xiaomiio&_json=true ,会得到下述信息,复制location中的url到新的界面打开:
|
|
27
|
+
|
|
28
|
+
```text
|
|
29
|
+
&&&START&&&{"serviceParam":"{\"checkSafePhone\":false,\"checkSafeAddress\":false,\"lsrp_score\":0.0}","qs":"%3Fsid%3Dxiaomiio%26_json%3Dtrue","code":70016,"description":"登录验证失败","securityStatus":0,"_sign":"0psXfr43eNI0IX6q9Suk3qWbRqU=","sid":"xiaomiio","result":"error","captchaUrl":null,"callback":"https://sts.api.io.mi.com/sts","location":"https://account.xiaomi.com/fe/service/login?_json=true&sid=xiaomiio&qs=%253Fsid%253Dxiaomiio%2526_json%253Dtrue&callback=.........","pwd":0,"child":0,"desc":"登录验证失败"}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
打开后会进入小米的登录界面(如果直接显示了`ok`,是因为保存了之前的cookie,建议使用无痕窗口重新开始上述步骤),此时需要先按下 `F12` 打开开发者工具,切换到`Network`选项卡,之后可以输入账号密码或者扫码登录。完成后页面会显示一个`ok`。
|
|
33
|
+
|
|
34
|
+
此时在网络选项卡中按下`Ctrl+F`,搜索上述所需的`userId`, `ssecurity`, `deviceId`, `serviceToken`即可。
|
|
35
|
+
|
|
36
|
+
或者筛选请求:
|
|
37
|
+
1. `https://sts.api.io.mi.com/sts`,其中的`set-cookie`中包含`userId`和`serviceToken`(`=`到`;`前止)。
|
|
38
|
+
2. `https://account.xiaomi.com/pass/serviceLoginAuth2/end`,其中的`extension-pragma`中包含`ssecurity`(`:"`到`"`前止)。
|
|
39
|
+
3. `https://account.xiaomi.com/identity/authStart`,其中的`cookie`中包含`deviceId`(`=`到`;`前止)。
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
### API
|
|
43
|
+
|
|
44
|
+
`mijiaAPI`:API的实现,使用`mijiaLogin`登录后返回的信息进行初始化
|
|
45
|
+
* `__init__(auth_data: dict)`:初始化
|
|
46
|
+
* `available -> bool`:传入的`auth_data`是否有效
|
|
47
|
+
* `get_devices_list() -> list`:获取设备列表
|
|
48
|
+
* `get_homes_list() -> list`:获取家庭列表,家庭字典中包含房间列表
|
|
49
|
+
* `get_scenes_list(home_id: str) -> list`:获取手动场景列表,在 *米家->添加->手动控制* 中设置
|
|
50
|
+
* `run_scene(scene_id: str) -> bool`:运行手动场景
|
|
51
|
+
* `get_consumable_items(home_id: str) -> list`:获取设备的耗材信息
|
|
52
|
+
* `get_devices_prop(data: list) -> list`:获取设备的属性
|
|
53
|
+
* `set_devices_prop(data: list) -> list`:设置设备的属性
|
|
54
|
+
* `data`为一个字典的列表,字典需要包含`did`, `siid`, `piid`,后面两个键可从 *https://home.miot-spec.com/spec/{model}* 中获取,其中`model`为设备的model,在设备列表中获取,如[米家台灯 1S](https://home.miot-spec.com/spec/yeelink.light.lamp4)。
|
|
55
|
+
* 网站上的方法并非全部可用,需要自行测试
|
|
56
|
+
* `run_action(data: dict) -> dict`:执行设备的action
|
|
57
|
+
* `data`为一个字典,需要包含`did`, `siid`, `aiid`,获取方法同上
|
|
58
|
+
|
|
59
|
+
### 针对设备的封装
|
|
60
|
+
|
|
61
|
+
`mijiaDevices`:使用`mijiaAPI`和设备属性字典初始化,以便更方便地调用设备属性
|
|
62
|
+
* `__init__(api: mijiaAPI, dev_info: dict. did: str = None, sleep_time: float = 0.5)`:初始化,`dev_info`为设备属性,参考[demos/dev_info_example](demos/dev_info_example),`sleep_time`为每次调用设备属性的间隔时间(注:设置属性后立刻获取属性会不符合预期,需要延迟一段时间)
|
|
63
|
+
* `set(name: str, did: str, value: Union[bool, int]) -> Union[bool, int]`:设置设备属性
|
|
64
|
+
* `get(name: str, did: str) -> Union[bool, int]`:获取设备属性
|
|
65
|
+
* v1.2.0 新增直接通过名称设置/获取属性,需要在初始化时传入`did`,详见[demos/test_devices_v2_light.py](demos/test_devices_v2_light.py)。名称中包含`-`的属性需要替换为`_`。
|
|
66
|
+
* 可以调用`get_device_info(device_model: str) -> dict`函数从[米家设备列表](https://home.miot-spec.com/)在线获取设备属性字典,详见[demos/test_get_device_info.py](demos/test_get_device_info.py)
|
|
67
|
+
|
|
68
|
+
## 致谢
|
|
69
|
+
* [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)
|
|
70
|
+
|
|
71
|
+
## 声明
|
|
72
|
+
* 本项目仅供学习交流使用,不得用于商业用途,如有侵权请联系删除。
|
|
73
|
+
* 本项目作者不对使用本项目产生的任何后果负责,请用户自行承担使用本项目的风险。
|
|
@@ -197,7 +197,7 @@ def get_device_info(device_model: str) -> dict:
|
|
|
197
197
|
if item['range'] is not None:
|
|
198
198
|
item['range'] = item['range']
|
|
199
199
|
if item['name'] in properties_name:
|
|
200
|
-
item["name"] = f'{services[siid][
|
|
200
|
+
item["name"] = f'{services[siid]["name"]}-{item["name"]}'
|
|
201
201
|
properties_name.append(item['name'])
|
|
202
202
|
result['properties'].append({k: None if v == 'none' else v for k, v in item.items()})
|
|
203
203
|
if 'actions' in services[siid]:
|
|
@@ -1,155 +1,163 @@
|
|
|
1
|
-
from typing import Tuple
|
|
2
|
-
import hashlib
|
|
3
|
-
import json
|
|
4
|
-
import os
|
|
5
|
-
import random
|
|
6
|
-
import string
|
|
7
|
-
import
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
import
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
from .
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
self.
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
self.
|
|
26
|
-
self.session.
|
|
27
|
-
|
|
28
|
-
'
|
|
29
|
-
'Accept
|
|
30
|
-
'Accept-
|
|
31
|
-
'
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
data.
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
'
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
'
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
'
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
if
|
|
82
|
-
raise LoginError(
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
'
|
|
119
|
-
'
|
|
120
|
-
'
|
|
121
|
-
'
|
|
122
|
-
'
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
if
|
|
138
|
-
raise LoginError(
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
'
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
if
|
|
149
|
-
raise LoginError(
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
1
|
+
from typing import Tuple
|
|
2
|
+
import hashlib
|
|
3
|
+
import json
|
|
4
|
+
import os
|
|
5
|
+
import random
|
|
6
|
+
import string
|
|
7
|
+
import sys
|
|
8
|
+
import time
|
|
9
|
+
from urllib import parse
|
|
10
|
+
|
|
11
|
+
from qrcode import QRCode
|
|
12
|
+
import requests
|
|
13
|
+
|
|
14
|
+
from .urls import msgURL, loginURL, qrURL
|
|
15
|
+
from .utils import defaultUA
|
|
16
|
+
|
|
17
|
+
class LoginError(Exception):
|
|
18
|
+
def __init__(self, code: int, message: str):
|
|
19
|
+
self.code = code
|
|
20
|
+
self.message = message
|
|
21
|
+
super().__init__(f'Error code: {code}, message: {message}')
|
|
22
|
+
|
|
23
|
+
class mijiaLogin(object):
|
|
24
|
+
def __init__(self):
|
|
25
|
+
self.deviceId = ''.join(random.sample(string.digits + string.ascii_letters, 16))
|
|
26
|
+
self.session = requests.Session()
|
|
27
|
+
self.session.headers.update({
|
|
28
|
+
'User-Agent': defaultUA,
|
|
29
|
+
'Accept': '*/*',
|
|
30
|
+
'Accept-Encoding': 'gzip, deflate, br, zstd',
|
|
31
|
+
'Accept-Language': 'zh-CN,zh;q=0.9',
|
|
32
|
+
'Cookie': f'deviceId={self.deviceId}; sdkVersion=3.4.1'
|
|
33
|
+
})
|
|
34
|
+
|
|
35
|
+
def _get_index(self) -> Tuple[requests.Session, dict]:
|
|
36
|
+
ret = self.session.get(msgURL)
|
|
37
|
+
if ret.status_code != 200:
|
|
38
|
+
raise LoginError(ret.status_code, f'Failed to get index page, {ret.text}')
|
|
39
|
+
ret_data = json.loads(ret.text[11:])
|
|
40
|
+
data = {'deviceId': self.deviceId}
|
|
41
|
+
data.update({
|
|
42
|
+
k: v for k, v in ret_data.items() \
|
|
43
|
+
if k in ['qs', '_sign', 'callback', 'location']
|
|
44
|
+
})
|
|
45
|
+
return data
|
|
46
|
+
|
|
47
|
+
def login(self, username: str, password: str) -> dict:
|
|
48
|
+
"""login with username and password
|
|
49
|
+
mijiaLogin.login(username: str, password: str) -> dict
|
|
50
|
+
-------
|
|
51
|
+
@param
|
|
52
|
+
username: str, xiaomi account username(email/phone number/xiaomi id)
|
|
53
|
+
password: str, xiaomi account password
|
|
54
|
+
-------
|
|
55
|
+
@return
|
|
56
|
+
dict, data for authorization, including userId, ssecurity, deviceId, serviceToken
|
|
57
|
+
"""
|
|
58
|
+
warning_msg = 'WARNING: there is a high probability of verification code with account and password. Please try other login methods'
|
|
59
|
+
if sys.stdout.isatty():
|
|
60
|
+
print(f'\033[33;1m{warning_msg}\033[0m')
|
|
61
|
+
else:
|
|
62
|
+
print(warning_msg)
|
|
63
|
+
data = self._get_index()
|
|
64
|
+
post_data = {
|
|
65
|
+
'qs': data['qs'],
|
|
66
|
+
'_sign': data['_sign'],
|
|
67
|
+
'callback': data['callback'],
|
|
68
|
+
'sid': 'xiaomiio',
|
|
69
|
+
'_json': 'true',
|
|
70
|
+
'user': username,
|
|
71
|
+
'hash': (hashlib.md5(password.encode()).hexdigest().upper() + '0' * 32)[:32],
|
|
72
|
+
}
|
|
73
|
+
ret = self.session.post(loginURL, data=post_data)
|
|
74
|
+
if ret.status_code != 200:
|
|
75
|
+
raise LoginError(ret.status_code, f'Failed to post login page, {ret.text}')
|
|
76
|
+
ret_data = json.loads(ret.text[11:])
|
|
77
|
+
if ret_data['code'] != 0:
|
|
78
|
+
raise LoginError(ret_data['code'], ret_data['desc'])
|
|
79
|
+
if 'location' not in ret_data:
|
|
80
|
+
raise LoginError(-1, 'Failed to get location')
|
|
81
|
+
if 'notificationUrl' in ret_data:
|
|
82
|
+
raise LoginError(-1, 'Verification code required, please try other login methods')
|
|
83
|
+
auth_data = {
|
|
84
|
+
'userId': ret_data['userId'],
|
|
85
|
+
'ssecurity': ret_data['ssecurity'],
|
|
86
|
+
'deviceId': data['deviceId'],
|
|
87
|
+
}
|
|
88
|
+
ret = self.session.get(ret_data['location'])
|
|
89
|
+
if ret.status_code != 200:
|
|
90
|
+
raise LoginError(ret.status_code, f'Failed to get location, {ret.text}')
|
|
91
|
+
cookies = self.session.cookies.get_dict()
|
|
92
|
+
auth_data['serviceToken'] = cookies['serviceToken']
|
|
93
|
+
self.auth_data = auth_data
|
|
94
|
+
return auth_data
|
|
95
|
+
|
|
96
|
+
@staticmethod
|
|
97
|
+
def _print_qr(loginurl: str, box_size: int = 10) -> None:
|
|
98
|
+
print('Scan the QR code below with Mi Home app')
|
|
99
|
+
qr = QRCode(border=1, box_size=box_size)
|
|
100
|
+
qr.add_data(loginurl)
|
|
101
|
+
qr.make_image().save('qr.png')
|
|
102
|
+
try:
|
|
103
|
+
qr.print_ascii(invert=True, tty=True)
|
|
104
|
+
except OSError:
|
|
105
|
+
print('Failed to print QR code to terminal, please use the qr.png file in the current directory.')
|
|
106
|
+
|
|
107
|
+
def QRlogin(self) -> dict:
|
|
108
|
+
"""login with QR code
|
|
109
|
+
mijiaLogin.QRlogin() -> dict
|
|
110
|
+
-------
|
|
111
|
+
@return
|
|
112
|
+
dict, data for authorization, including userId, ssecurity, deviceId, serviceToken
|
|
113
|
+
"""
|
|
114
|
+
data = self._get_index()
|
|
115
|
+
location = data['location']
|
|
116
|
+
location_parsed = parse.parse_qs(parse.urlparse(location).query)
|
|
117
|
+
params = {
|
|
118
|
+
'_qrsize': 240,
|
|
119
|
+
'qs': data['qs'],
|
|
120
|
+
'bizDeviceType': '',
|
|
121
|
+
'callback': data['callback'],
|
|
122
|
+
'_json': 'true',
|
|
123
|
+
'theme': '',
|
|
124
|
+
'sid': 'xiaomiio',
|
|
125
|
+
'needTheme': 'false',
|
|
126
|
+
'showActiveX': 'false',
|
|
127
|
+
'serviceParam': location_parsed['serviceParam'][0],
|
|
128
|
+
'_local': 'zh_CN',
|
|
129
|
+
'_sign': data['_sign'],
|
|
130
|
+
'_dc': str(int(time.time() * 1000)),
|
|
131
|
+
}
|
|
132
|
+
url = qrURL + '?' + parse.urlencode(params)
|
|
133
|
+
ret = self.session.get(url)
|
|
134
|
+
if ret.status_code != 200:
|
|
135
|
+
raise LoginError(ret.status_code, f'Failed to get QR code URL, {ret.text}')
|
|
136
|
+
ret_data = json.loads(ret.text[11:])
|
|
137
|
+
if ret_data['code'] != 0:
|
|
138
|
+
raise LoginError(ret_data['code'], ret_data['desc'])
|
|
139
|
+
loginurl = ret_data['loginUrl']
|
|
140
|
+
self._print_qr(loginurl)
|
|
141
|
+
try:
|
|
142
|
+
ret = self.session.get(ret_data['lp'], timeout=60, headers={'Connection': 'keep-alive'})
|
|
143
|
+
except requests.exceptions.Timeout:
|
|
144
|
+
raise LoginError(-1, 'Timeout, please try again')
|
|
145
|
+
if ret.status_code != 200:
|
|
146
|
+
raise LoginError(ret.status_code, f'Failed to wait for login, {ret.text}')
|
|
147
|
+
ret_data = json.loads(ret.text[11:])
|
|
148
|
+
if ret_data['code'] != 0:
|
|
149
|
+
raise LoginError(ret_data['code'], ret_data['desc'])
|
|
150
|
+
auth_data = {
|
|
151
|
+
'userId': ret_data['userId'],
|
|
152
|
+
'ssecurity': ret_data['ssecurity'],
|
|
153
|
+
'deviceId': data['deviceId'],
|
|
154
|
+
}
|
|
155
|
+
ret = self.session.get(ret_data['location'])
|
|
156
|
+
if ret.status_code != 200:
|
|
157
|
+
raise LoginError(ret.status_code, f'Failed to get location, {ret.text}')
|
|
158
|
+
cookies = self.session.cookies.get_dict()
|
|
159
|
+
auth_data['serviceToken'] = cookies['serviceToken']
|
|
160
|
+
self.auth_data = auth_data
|
|
161
|
+
if os.path.exists('qr.png'):
|
|
162
|
+
os.remove('qr.png')
|
|
163
|
+
return auth_data
|
|
@@ -1,6 +1,18 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "mijiaAPI"
|
|
3
|
+
version = "1.3.5"
|
|
4
|
+
description = "A Python API for Xiaomi Mijia"
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
requires-python = ">=3.9,<4.0"
|
|
7
|
+
dependencies = [
|
|
8
|
+
"pillow>=11.0.0,<12.0.0",
|
|
9
|
+
"qrcode>=8.0,<9.0",
|
|
10
|
+
"requests>=2.32.3,<3.0.0",
|
|
11
|
+
]
|
|
12
|
+
|
|
1
13
|
[tool.poetry]
|
|
2
14
|
name = "mijiaAPI"
|
|
3
|
-
version = "1.3.
|
|
15
|
+
version = "1.3.6"
|
|
4
16
|
description = "A Python API for Xiaomi Mijia"
|
|
5
17
|
authors = ["Do1e <dpj.email@qq.com>"]
|
|
6
18
|
license = "GPLv3"
|
mijiaapi-1.3.4/PKG-INFO
DELETED
|
@@ -1,76 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.3
|
|
2
|
-
Name: mijiaAPI
|
|
3
|
-
Version: 1.3.4
|
|
4
|
-
Summary: A Python API for Xiaomi Mijia
|
|
5
|
-
License: GPLv3
|
|
6
|
-
Author: Do1e
|
|
7
|
-
Author-email: dpj.email@qq.com
|
|
8
|
-
Requires-Python: >=3.9,<4.0
|
|
9
|
-
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
|
|
10
|
-
Classifier: License :: Other/Proprietary License
|
|
11
|
-
Classifier: Operating System :: OS Independent
|
|
12
|
-
Classifier: Programming Language :: Python :: 3
|
|
13
|
-
Classifier: Programming Language :: Python :: 3.9
|
|
14
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
15
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
16
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
17
|
-
Classifier: Programming Language :: Python :: 3.13
|
|
18
|
-
Requires-Dist: pillow (>=11.0.0,<12.0.0)
|
|
19
|
-
Requires-Dist: qrcode (>=8.0,<9.0)
|
|
20
|
-
Requires-Dist: requests (>=2.32.3,<3.0.0)
|
|
21
|
-
Project-URL: Homepage, https://github.com/Do1e/mijia-api
|
|
22
|
-
Project-URL: Repository, https://github.com/Do1e/mijia-api
|
|
23
|
-
Description-Content-Type: text/markdown
|
|
24
|
-
|
|
25
|
-
# mijiaAPI
|
|
26
|
-
小米米家设备的api,可以使用代码直接控制米家设备的功能,[Github link](https://github.com/Do1e/mijia-api),[PyPI link](https://pypi.org/project/mijiaAPI/)。
|
|
27
|
-
|
|
28
|
-
## 安装
|
|
29
|
-
```bash
|
|
30
|
-
poetry install
|
|
31
|
-
```
|
|
32
|
-
或者
|
|
33
|
-
```bash
|
|
34
|
-
pip install mijiaAPI
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## 使用
|
|
38
|
-
使用实例可以参考`demos`文件夹下的示例代码,以下是简单的使用说明
|
|
39
|
-
|
|
40
|
-
有三个类分别用于登录和API调用
|
|
41
|
-
|
|
42
|
-
* `mijiaLogin`:登录小米账号,获取控制设备必须的`userId`, `ssecurity`, `deviceId`, `serviceToken`,方法列表
|
|
43
|
-
* `login(username: str, password: str) -> dict`:账号密码登录,返回上述信息
|
|
44
|
-
* `QRlogin() -> dict`:扫描二维码登录,返回上述信息(会在支持tty的终端打印二维码,若打印识别可查看当前文件夹下的`qr.png`)
|
|
45
|
-
|
|
46
|
-
* `mijiaAPI`:API的实现,使用`mijiaLogin`登录后返回的信息进行初始化
|
|
47
|
-
* `__init__(auth_data: dict)`:初始化
|
|
48
|
-
* `available -> bool`:传入的`auth_data`是否有效
|
|
49
|
-
* `get_devices_list() -> list`:获取设备列表
|
|
50
|
-
* `get_homes_list() -> list`:获取家庭列表,家庭字典中包含房间列表
|
|
51
|
-
* `get_scenes_list(home_id: str) -> list`:获取手动场景列表,在 *米家->添加->手动控制* 中设置
|
|
52
|
-
* `run_scene(scene_id: str) -> bool`:运行手动场景
|
|
53
|
-
* `get_consumable_items(home_id: str) -> list`:获取设备的耗材信息
|
|
54
|
-
* `get_devices_prop(data: list) -> list`:获取设备的属性
|
|
55
|
-
* `set_devices_prop(data: list) -> list`:设置设备的属性
|
|
56
|
-
* `data`为一个字典的列表,字典需要包含`did`, `siid`, `piid`,后面两个键可从 *https://home.miot-spec.com/spec/{model}* 中获取,其中`model`为设备的model,在设备列表中获取,如[米家台灯 1S](https://home.miot-spec.com/spec/yeelink.light.lamp4)。
|
|
57
|
-
* 网站上的方法并非全部可用,需要自行测试
|
|
58
|
-
* `run_action(data: dict) -> dict`:执行设备的action
|
|
59
|
-
* `data`为一个字典,需要包含`did`, `siid`, `aiid`,获取方法同上
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
* `mijiaDevices`:使用`mijiaAPI`和设备属性字典初始化,以便更方便地调用设备属性
|
|
63
|
-
* `__init__(api: mijiaAPI, dev_info: dict. did: str = None, sleep_time: float = 0.5)`:初始化,`dev_info`为设备属性,参考[demos/dev_info_example](demos/dev_info_example),`sleep_time`为每次调用设备属性的间隔时间(注:设置属性后立刻获取属性会不符合预期,需要延迟一段时间)
|
|
64
|
-
* `set(name: str, did: str, value: Union[bool, int]) -> Union[bool, int]`:设置设备属性
|
|
65
|
-
* `get(name: str, did: str) -> Union[bool, int]`:获取设备属性
|
|
66
|
-
* v1.2.0 新增直接通过名称设置/获取属性,需要在初始化时传入`did`,详见[demos/test_devices_v2_light.py](demos/test_devices_v2_light.py)。名称中包含`-`的属性需要替换为`_`。
|
|
67
|
-
* **欢迎大家把自己编写的设备属性字典分享到Issues中,方便大家使用**
|
|
68
|
-
* 也可以调用`get_device_info(device_model: str) -> dict`函数从[米家设备列表](https://home.miot-spec.com/)在线获取设备属性字典,详见[demos/test_get_device_info.py](demos/test_get_device_info.py)
|
|
69
|
-
|
|
70
|
-
## 致谢
|
|
71
|
-
* [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)
|
|
72
|
-
|
|
73
|
-
## 声明
|
|
74
|
-
* 本项目仅供学习交流使用,不得用于商业用途,如有侵权请联系删除。
|
|
75
|
-
* 本项目作者不对使用本项目产生的任何后果负责,请用户自行承担使用本项目的风险。
|
|
76
|
-
|
mijiaapi-1.3.4/README.md
DELETED
|
@@ -1,51 +0,0 @@
|
|
|
1
|
-
# mijiaAPI
|
|
2
|
-
小米米家设备的api,可以使用代码直接控制米家设备的功能,[Github link](https://github.com/Do1e/mijia-api),[PyPI link](https://pypi.org/project/mijiaAPI/)。
|
|
3
|
-
|
|
4
|
-
## 安装
|
|
5
|
-
```bash
|
|
6
|
-
poetry install
|
|
7
|
-
```
|
|
8
|
-
或者
|
|
9
|
-
```bash
|
|
10
|
-
pip install mijiaAPI
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
## 使用
|
|
14
|
-
使用实例可以参考`demos`文件夹下的示例代码,以下是简单的使用说明
|
|
15
|
-
|
|
16
|
-
有三个类分别用于登录和API调用
|
|
17
|
-
|
|
18
|
-
* `mijiaLogin`:登录小米账号,获取控制设备必须的`userId`, `ssecurity`, `deviceId`, `serviceToken`,方法列表
|
|
19
|
-
* `login(username: str, password: str) -> dict`:账号密码登录,返回上述信息
|
|
20
|
-
* `QRlogin() -> dict`:扫描二维码登录,返回上述信息(会在支持tty的终端打印二维码,若打印识别可查看当前文件夹下的`qr.png`)
|
|
21
|
-
|
|
22
|
-
* `mijiaAPI`:API的实现,使用`mijiaLogin`登录后返回的信息进行初始化
|
|
23
|
-
* `__init__(auth_data: dict)`:初始化
|
|
24
|
-
* `available -> bool`:传入的`auth_data`是否有效
|
|
25
|
-
* `get_devices_list() -> list`:获取设备列表
|
|
26
|
-
* `get_homes_list() -> list`:获取家庭列表,家庭字典中包含房间列表
|
|
27
|
-
* `get_scenes_list(home_id: str) -> list`:获取手动场景列表,在 *米家->添加->手动控制* 中设置
|
|
28
|
-
* `run_scene(scene_id: str) -> bool`:运行手动场景
|
|
29
|
-
* `get_consumable_items(home_id: str) -> list`:获取设备的耗材信息
|
|
30
|
-
* `get_devices_prop(data: list) -> list`:获取设备的属性
|
|
31
|
-
* `set_devices_prop(data: list) -> list`:设置设备的属性
|
|
32
|
-
* `data`为一个字典的列表,字典需要包含`did`, `siid`, `piid`,后面两个键可从 *https://home.miot-spec.com/spec/{model}* 中获取,其中`model`为设备的model,在设备列表中获取,如[米家台灯 1S](https://home.miot-spec.com/spec/yeelink.light.lamp4)。
|
|
33
|
-
* 网站上的方法并非全部可用,需要自行测试
|
|
34
|
-
* `run_action(data: dict) -> dict`:执行设备的action
|
|
35
|
-
* `data`为一个字典,需要包含`did`, `siid`, `aiid`,获取方法同上
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
* `mijiaDevices`:使用`mijiaAPI`和设备属性字典初始化,以便更方便地调用设备属性
|
|
39
|
-
* `__init__(api: mijiaAPI, dev_info: dict. did: str = None, sleep_time: float = 0.5)`:初始化,`dev_info`为设备属性,参考[demos/dev_info_example](demos/dev_info_example),`sleep_time`为每次调用设备属性的间隔时间(注:设置属性后立刻获取属性会不符合预期,需要延迟一段时间)
|
|
40
|
-
* `set(name: str, did: str, value: Union[bool, int]) -> Union[bool, int]`:设置设备属性
|
|
41
|
-
* `get(name: str, did: str) -> Union[bool, int]`:获取设备属性
|
|
42
|
-
* v1.2.0 新增直接通过名称设置/获取属性,需要在初始化时传入`did`,详见[demos/test_devices_v2_light.py](demos/test_devices_v2_light.py)。名称中包含`-`的属性需要替换为`_`。
|
|
43
|
-
* **欢迎大家把自己编写的设备属性字典分享到Issues中,方便大家使用**
|
|
44
|
-
* 也可以调用`get_device_info(device_model: str) -> dict`函数从[米家设备列表](https://home.miot-spec.com/)在线获取设备属性字典,详见[demos/test_get_device_info.py](demos/test_get_device_info.py)
|
|
45
|
-
|
|
46
|
-
## 致谢
|
|
47
|
-
* [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)
|
|
48
|
-
|
|
49
|
-
## 声明
|
|
50
|
-
* 本项目仅供学习交流使用,不得用于商业用途,如有侵权请联系删除。
|
|
51
|
-
* 本项目作者不对使用本项目产生的任何后果负责,请用户自行承担使用本项目的风险。
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|