南边电网电费数据集成，支持短信验证码和扫码登岸

飞飞姐

出处：https://bbs.hassbian.com/thread-18578-1-4.html

2024.09.19 已经适配最新登录API，可选择短信验证码或扫码登录。

南方电网电费数据HA集成

本集成已经加入HACS默认存储库，可以在HACS直接搜索安装注意：本集成需求Home Assistant最低版本为2022.11。本集成仅适用于南方电网覆盖范围（广东、广西、云南、贵州、海南），国网接口与南网不通用，因此无法适配。--------------------------------2024.09.19更新---------------------------------------------------v1.2.0 更新登录方式功能性更新：

• 由于登录API调解，原账号密码登录方式已失效。目前支持手机号+短信验证码，手机号+密码+短信验证码和南网在线APP、微信、支付宝扫码登录。
  
• 更改了初次加载集成或重载集成时的更新逻辑，初次更新数据不会再阻塞UI界面。更改了电费账户的移除逻辑，目前版本如需移除账号，可直接删除设备。
  

非功能性更新：

• 增加了更多获取日电量的API，将会在之后版本使用。
  
• 更新了账号登录态过期的处理逻辑。南网API库的细节更改。
  

如有新增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支持功能

• ✅支持南方电网覆盖范围内的电费数据查询（广东、广西、云南、贵州、海南）
  
• ✅支持使用手机号、短信验证码和密码（可选）登录，支持南网在线APP、微信、支付宝扫码登录
  
• ✅支持多个南网账户（每个账户一个集成），支持单个账户下的多个缴费号
  
• ✅数据自动抓取和更新（默认间隔4小时，可设置）✅全程GUI设置，无需编辑yaml举行设置（暂不支持yaml设置）
  

可接入如下数据：

• 当前余额和欠费
  
• 当前阶梯电量数据（档位、阶梯剩余电量、阶梯电价）
  
• 昨日用电量
  
• 最新一日用电量、电费（取有数据的最近一日）
  
• 本年度总用电量、总电费（非及时，更新到上个月）
  
• 本年度每月用电量、电费（非及时，更新到上个月）
  
• 上年度总用电量、总电费
  
• 上年度每月用电量、电费
  
• 当月累计用电量、电费（非及时，有2天左右的耽误）
  
• 当月每日用电量、电费（非及时，有2天左右的耽误）
  
• 上月累计用电量、电费上月每日用电量、电费
  

❌不支持阶梯电费设置（仅能获取当前所在阶梯）、峰谷电价设置和电费盘算（本插件只举行数据抓取和转换，不举行任何盘算），
暂时也没有支持计划（南网暂时没有统一的API），如有需求，发起单独创建对应的电价实体。❌因为南网登录API调解，不再支持登录态失效之后自动重新登录，需要手动重新登录。使用方法

使用HACS或手动下载安装注意：本集成需求Home Assistant最低版本为2022.11。传感器列表

• 余额
  
• 欠费
  
• 当前阶梯档位
  
• 当前阶梯剩余电量
  
• 当前阶梯电价
  
• 上月电费
  
• 上月用电量
  
• 当月用电量
  
• 当月电费
  
• 本年度电费
  
• 本年度用电量
  
• 上年度电费
  
• 上年度用电量
  
• 最近日用电量
  
• 最近日电费昨日用电量
  

Thank you

lyylyylyylyy: PR #30 短信验证码登录支持

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

• 不折腾，超简朴接入电费数据
  
• 北京电费查询加强版
  
• 电费插件（Node-Red流）-广东南方电网【抄作业】电费插件(NR流)-南网
  

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

北京首负

不错，谢谢

碧蓝海天

谢谢了

李飞宇

谢谢谢谢

近期关注

谢谢各位大神了

林华帅

优秀优秀

陳銳

图文搭配很好，理解更快。

郎榕

讲解很专业，看得出经验很足。

许海祥

路过，支持一下啦

东方月

代码注释很详细，容易理解。