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 .