请选择 进入手机版 | 继续访问电脑版

『瀚思彼岸』» 智能家居技术论坛

 找回密码
 立即注册
查看: 1644|回复: 61

[插件集成] 南方电网电费数据集成,支持用户名和密码直接登陆

[复制链接]

2

主题

26

帖子

296

积分

论坛技术达人

积分
296
金钱
265
HASS币
20
发表于 2022-11-19 13:28:45 | 显示全部楼层 |阅读模式
本帖最后由 cubicpill 于 2022-12-1 23:10 编辑

南方电网电费数据HA集成

注意:本集成需求Home Assistant最低版本为2022.8

01/12/2022 更新 v1.0.2,此版本包含重要bug修复,请更新

--------------------------------以下正文---------------------------------------------------

在论坛里看到 @louis_lee 大佬写的国网电费数据接入,奈何lz人在南网区域内,没办法直接用现成的插件。
看了一下论坛里大部分都是用Node-RED配合抓包得到的数据接入,比较麻烦,正好最近有点空研究了一下国网网上营业厅的登陆页面,发现比想象中容易,一步一步把登陆时的加密解密实现了。
后来发现网页端的登录态几个小时就会过期,于是又抓包研究了一下App(南网在线),发现App和网页端接口基本相同,但是登录态有效时间长很多,于是切换到了App端的API。
第一次写HA的集成,磕磕绊绊从有想法开始到最终实现写了接近两个周,期间参考了无数论坛和Github前辈们的代码,难免会有一些bug,请见谅。

由于该集成直接使用 Web API 登陆,因此资源消耗相对较小,性能较弱的机器也可以放心使用。

目前实现的功能见下文,也可以直接到Github看:https://github.com/CubicPill/china_southern_power_grid_stat

支持功能

  • 支持南方电网覆盖范围内的电费数据查询(广东、广西、云南、贵州、海南)
  • 支持使用手机号和密码登陆,支持登录态失效之后自动重新登陆
  • 支持多个南网账户(每个账户一个集成),支持单个账户下的多个缴费号
  • 数据自动抓取和更新(默认间隔4小时,可配置)
  • 全程GUI配置,无需编辑yaml进行配置(暂不支持yaml配置)

可接入如下数据:

  • 当前余额和欠费
  • 昨日用电量- 最新日电量
  • 本年度总用电量和总电费(非实时,更新到上个月)
  • 本年度内每月用电量和电费(非实时,更新到上个月)
  • 上年度总用电量和总电费
  • 上年度每月用电量和电费
  • 当月累计用电量(非实时,有2天左右的延迟)
  • 当月内每日用电量(非实时,有2天左右的延迟)
  • 上月累计用电量(月初可能有2天左右延迟)
  • 上月每日用电量(月初有2天左右的延迟)

不支持阶梯电费设置、峰谷电价设置和电费计算(本插件只进行数据抓取和转换,不进行任何计算),暂时也没有支持计划(南网暂时没有统一的API)。如有需求,建议单独创建对应的电价实体。

使用方法

使用HACS添加自定义存储库(不是搜索)手动下载安装

使用手机号和密码登陆
setup_login.png

配置界面
setup_add_account.png

添加缴费号
setup_select_account.png

传感器列表
sensors.png

传感器额外参数(每月用量、每日用量)
sensor_attr.png

参数设置
setup_params.png

数据更新策略

由于上月数据和去年数据在生成之后一般不会发生变化,因此对于上月累计用电量、上月每日用电量、上年度累计用电量、上年度每月用电量,数据更新间隔将会与一般更新间隔有所不同。
具体更新策略如下:

对于上月数据,在每月前5天(1~5日)将会跟随一般更新间隔更新(默认为4小时),其余时间将会停止更新,但数据依然可用。

对于去年数据,在每年一月的前5天(1月1日~1月5日)将会每天更新(在每天第一次触发更新时更新),其余时间将会停止更新,但数据依然可用。

如果需要强制刷新数据,重载集成即可。

一些技术细节

登陆接口加密原理

此部分较为敏感,详见 github repo

Web端接口和App端接口

对于南网API相关信息的提取主要通过Web端的抓包和JS代码获取。
之后因为登录态有效期问题,对App端抓包进行比对后切换到App端API。
经过验证,Web端(网上营业厅)和App端(南网在线)的API接口基本相同,差别主要在于:

Web App
API路径 ucs/ma/wt/ ucs/ma/zt/
支持登陆方式 手机号+密码/验证码,南网在线/微信/支付宝扫码 手机号+密码/验证码
token有效期 几小时 较长
Cookies token包含在cookies中 无cookies
敏感信息(姓名、地址等) 部分信息用“*”隐去 有明文全文

另外在HTTP请求头上有细微的差别(如:UA),但实际上对于请求的返回结果没有影响。

API 实现库

详见 github repo

代码和功能设计参考

感谢瀚思彼岸论坛以下帖子作者的辛苦付出,排名不分先后

自定义集成教程参考:Building a Home Assistant Custom Component Part 1: Project Structure and Basics















评分

参与人数 7金钱 +83 HASS币 +20 收起 理由
25989406 + 10 论坛有你更精彩!
chenquanhao + 10 论坛有你更精彩!
ruike007 + 8 特别赞
佳艺造型 + 10 感谢楼主分享!
fsscyd + 5 终于见到南方电网的了,对小白来说太合适了.
+ 20 + 20 厉害了word楼主!
dscao + 20 论坛有你更精彩!

查看全部评分

回复

使用道具 举报

8

主题

142

帖子

608

积分

高级会员

Rank: 4

积分
608
金钱
466
HASS币
0
发表于 2022-11-19 14:24:52 来自手机 | 显示全部楼层
把国网也做了。坛子里国网那个用docker太耗费资源了。
回复

使用道具 举报

1

主题

31

帖子

289

积分

论坛分享达人

积分
289
金钱
258
HASS币
10
发表于 2022-11-19 14:56:16 | 显示全部楼层
厉害了,插件都出来了,我本来还想再让流程进化一下的,现在看来不用了哈哈哈哈哈
回复

使用道具 举报

0

主题

26

帖子

210

积分

中级会员

Rank: 3Rank: 3

积分
210
金钱
184
HASS币
0
发表于 2022-11-19 15:08:56 | 显示全部楼层
点添加已绑定的缴费号时候出现 Unknown error occurred
回复

使用道具 举报

18

主题

189

帖子

1415

积分

金牌会员

Rank: 6Rank: 6

积分
1415
金钱
1226
HASS币
0
发表于 2022-11-19 15:10:38 | 显示全部楼层
大佬,能否帮忙看下这个微信小程序的登陆怎么弄? token过一段时间就不行了。https://bbs.hassbian.com/thread-14730-1-1.html
回复

使用道具 举报

53

主题

810

帖子

5089

积分

元老级技术达人

积分
5089
金钱
4244
HASS币
220
发表于 2022-11-19 15:27:27 | 显示全部楼层
好东西,来学习学习。
回复

使用道具 举报

25

主题

54

帖子

2051

积分

论坛技术达人

积分
2051
金钱
1987
HASS币
60
发表于 2022-11-19 15:40:00 | 显示全部楼层
不考虑向后兼容的话,密码存储可以用公钥加密后的值以避免明文存储密码,token可以在内存中刷新,没必要通过reload集成的方式。对于密码错误之类的exception还可以在follow和sensor中优化,遇到错误就停下,以免反复尝试被锁号。
没意思,跑路了
回复

使用道具 举报

0

主题

35

帖子

247

积分

中级会员

Rank: 3Rank: 3

积分
247
金钱
212
HASS币
0
发表于 2022-11-19 17:51:16 | 显示全部楼层
真厉害啊,今晚试试
回复

使用道具 举报

2

主题

41

帖子

211

积分

中级会员

Rank: 3Rank: 3

积分
211
金钱
170
HASS币
0
发表于 2022-11-19 18:24:35 | 显示全部楼层
ucomeito 发表于 2022-11-19 15:08
点添加已绑定的缴费号时候出现 Unknown error occurred

我也是这样
回复

使用道具 举报

2

主题

370

帖子

1077

积分

金牌会员

Rank: 6Rank: 6

积分
1077
金钱
707
HASS币
0
发表于 2022-11-19 18:28:14 | 显示全部楼层
这是大佬,大佬。
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

Archiver|手机版|小黑屋|Hassbian

GMT+8, 2022-12-9 14:09 , Processed in 0.104566 second(s), 36 queries .

Powered by Discuz! X3.4

Copyright © 2001-2021, Tencent Cloud.

快速回复 返回顶部 返回列表