strom_api

strom_api

Program Restful serbaguna yang menggabungkan dan melayani data per jam untuk harga listrik .

Jalankan saja server ini, dan itu akan melakukan semua angkat berat untuk Anda.

Negara -negara yang disediakan

Spanyol (PvPC)

• Sumber Data: Redata API
• Server akan secara otomatis mengambil data harga untuk hari berikutnya, setiap hari pukul 20:30 (waktu Madrid).

Contoh

Otomatisasi Rumah

• Gunakan sebagai sumber data dalam otomatisasi rumah untuk membuat keputusan berdasarkan harga daya saat ini
• Lihat OpenHab_Example/strom_update.js (Anda harus membuat item yang direferensikan sebelumnya)

Titik akhir istirahat

• Skema Umum: titik akhir / timestampinsecondssincePoch / zona

• Zona harga yang tersedia

• Dapatkan 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 " }

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

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

• Dapatkan 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 adalah cap waktu dalam kedua kasus. 0 akan selalu mengembalikan harga saat ini dalam waktu setempat untuk zona yang diminta.

• Dokumentasi titik akhir terperinci

Mengapa saya harus menggunakan server ini melalui API lain?

• Kerangka waktu dapat diminta dalam hitungan detik sejak zaman
• Rata -rata harga untuk hari tertentu disediakan untuk mengklasifikasikan setiap harga dalam konteks harian
• Lebih mudah menggunakan titik akhir istirahat
• Memperbarui dan membersihkan data secara otomatis (diatur dan lupakan)
• Open source
• Kinerja yang bagus, terima kasih kepada Dart dan Alfred

Jalankan sendiri

Prasyarat

• Docker-Compose

Konfigurasikan

• beradaptasi lingkungan di .env , lihat * .env.example
• Jangan ubah tz
• Rating_margin adalah nilai margin dalam persen untuk klasifikasi harga. Default menjadi 10, yang berarti hanya harga 10% di bawah rata-rata harian akan dianggap off-peak. Harus antara 0 dan 99.

Pengaturan

• mengeksekusi ./deploy.sh
• Port default adalah 3001. Selamat . Anda sekarang memiliki strom_api yang berjalan di port ini. Ini dapat dengan mudah diproksikan secara terbalik jika perlu.

Memperbarui

• mengeksekusi ./deploy.sh akan selalu membangun kembali cabang utama repositori ini dan restart wadah

Perkembangan

Jalankan tes

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

Mensimulasikan tindakan GitHub

• act --secret-file my.secrets

Menghasilkan dokumen

• dart doc .