strom_api

Strom_api

一个多功能的RESTFUL计划，汇总并提供每小时的数据数据。

只需运行此服务器，它将为您提供所有繁重的举重。

提高国家

西班牙（PVPC）

• 数据来源：Redata API
• 服务器将自动获取第二天，每天20:30（马德里时间）的价格数据。

例子

家庭自动化

• 用作家庭自动化中的数据源以根据当前电力价格做出决策
• 请参阅OpenHab_example/strom_update.js （您之前需要创建引用的项目）

休息端点

• 一般模式：端点 / timestampinsecondssepoch /区域

• 可用的价格区

• 获取https://strom.coinerella.com/price/0/peninsular

   { "time" : " 2023-04-05 14:00:00.000+0200 " , "zone" : " peninsular " , "price" : 0.11416 , "price_rating_percent" : 64.18 , "price_rating" : " off_peak " }

• 获取https://strom.coinerella.com/price-average/0/canarias

   { "time" : " 2023-04-05 00:00:00.000 " , "zone" : " canarias " , "average_price" : 0.17787 }

• 获取https://strom.coinerella.com/price-daily/0/peninsular

   [{
       "time" : " 2023-04-05 00:00:00.000+0200 " ,
       "zone" : " peninsular " ,
       "price" : 0.10931 ,
       "price_rating_percent" : 87.88 ,
       "price_rating" : " off_peak "
   },
   {
       "time" : " 2023-04-05 01:00:00.000+0200 " ,
       "zone" : " peninsular " ,
       "price" : 0.10634 ,
       "price_rating_percent" : 85.5 ,
       "price_rating" : " off_peak "
   } ... ]

  0是两种情况下的时间戳。 0将始终在请求区域的当地时间返回当前价格。

• 详细的端点文档

为什么我要在另一台API上使用此服务器？

• 自时以来，可以在几秒钟内要求时间范围
• 提供给定日的价格平均水平以在每日上下文中对每个价格进行分类
• 更易于使用休息端点
• 自动更新并清理数据（设置和忘记）
• 开源
• 出色的表现，感谢Dart和Alfred

自己运行

先决条件

• Docker-Compose

配置

• 适应.env中的环境，请参阅 * .env.example
• 不要更改TZ
• rating_margin是价格分类百分比的保证金值。默认值为10，这意味着仅比每日平均水平低10％的价格将被视为非高峰。必须在0到99之间。

设置

• 执行./deploy.sh
• 默认端口为3001。恭喜。现在，您在此端口上有一个运行的Strom_API。如果需要，可以很容易地将其反向代理。

更新

• 执行./deploy.sh将始终重建此存储库的主要分支并重新启动容器

发展

运行测试

• dart test test/app_test_no_env.dart
• dart test test/app_test_with_env.dart

模拟github动作

• act --secret-file my.secrets

生成文档

• dart doc .