strom_api

strom_api

Un programme RESTful polyvalent qui agrége et sert des données horaires pour les prix de l'électricité .

Il suffit d'exécuter ce serveur et il fera tout le travail pour vous.

Pays de soupçon

Espagne (PVPC)

• Source de données: API Redata
• Le serveur rapportera automatiquement les données de prix pour le lendemain, chaque jour à 20h30 (heure de Madrid).

Exemples

Automatisation

• Utiliser comme source de données dans la domotique pour prendre des décisions en fonction du prix de l'alimentation actuel
• voir openhab_example / strom_update.js (vous devrez créer les éléments référencés avant)

Points de repos

• Schéma général: point de terminaison / horodat- centimètres

• Zones de prix disponibles

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

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

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

• Obtenez 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 est l'horodatage dans les deux cas. 0 renverra toujours le prix actuel dans l'heure locale pour la zone demandée.

• Documentation détaillée des points de terminaison

Pourquoi devrais-je utiliser ce serveur sur une autre API?

• Des délais peuvent être demandés en quelques secondes depuis l'époque
• La moyenne des prix pour la journée donnée est fournie pour classer chaque prix dans le contexte quotidien
• Points de terminaison de repos plus faciles à utiliser
• Mises à jour et nettoie automatiquement les données (définir et oublier)
• Open source
• Excellente performance, grâce à Dart et Alfred

Exécutez le vôtre

Condition préalable

• composer docker

Configurer

• Adapter l'environnement dans .env , voir * .env.example
• Ne changez pas de tz
• Rating_margin est une valeur de marge en pourcentage pour la classification des prix. Les défauts par défaut, ce qui signifie que les prix de 10% inférieurs à la moyenne quotidienne seront considérés comme hors pointe. Doit être entre 0 et 99.

Installation

• exécuter ./deploy.sh
• Le port par défaut est 3001. Félicitations . Vous avez maintenant un Strom_api en cours d'exécution sur ce port. Il peut facilement être proxéré inversé si nécessaire.

Mise à jour

• Exécution ./deploy.sh reconstruirea toujours la branche principale de ce référentiel et redémarrera le conteneur

Développement

Exécuter des tests

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

Simuler les actions GitHub

• act --secret-file my.secrets

Générer des documents

• dart doc .