strom_api

strom_api

電気価格の1時間ごとのデータを集約および提供する汎用性の高いRESTFULプログラム。

このサーバーを実行するだけで、それはあなたのためにすべての重い持ち上げを行います。

サポートされた国

スペイン（PVPC）

• データソース：Redata API
• サーバーは、毎日20:30（マドリード時間）に、翌日の価格データを自動的に取得します。

例

ホームオートメーション

• ホームオートメーションでデータソースとして使用して、現在の電力価格に基づいて決定を下す
• openhab_example/strom_update.jsを参照してください（参照されるアイテムを以前に作成する必要があります）

休憩エンドポイント

• 一般的なスキーマ：エンドポイント /タイムスタンパンサンセコンドセポック/ゾーン

• 利用可能な価格帯

• 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で使用する必要があるのですか？

• 時間枠はエポック以来数秒で要求できます
• 与えられた日の価格平均は、毎日のコンテキストで各価格を分類するために提供されます
• 使用しやすいRESTエンドポイント
• データを自動的に更新およびクリーンアップします（設定して忘れます）
• オープンソース
• ダートとアルフレッドのおかげで、素晴らしいパフォーマンス

あなた自身を実行します

前提条件

• docker-compose

設定します

• 環境を.envに適応させ、 * .env.exampleを参照してください
• TZを変更しないでください
• rating_marginは、価格分類のパーセントのマージン値です。デフォルトは10です。つまり、1日の平均を10％下回る価格のみがオフピークと見なされます。 0〜99の間でなければなりません。

設定

• execute ./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 .