strom_api

strom_api

Универсальная программа RESTFUL , которая собирает и обслуживает почасовые данные по ценам на электроэнергию .

Просто запустите этот сервер, и он сделает для вас всю тяжелую работу.

Страны

Испания (PVPC)

• Источник данных: Redata API
• Сервер автоматически принесет данные о ценах на следующий день, каждый день в 20:30 (мадридское время).

Примеры

Домашняя автоматизация

• Используйте в качестве источника данных в домашней автоматизации для принятия решений на основе текущей цены мощности
• См. Openhab_example/strom_update.js (вам нужно создать ссылочные элементы раньше)

Постоянные конечные точки

• Общая схема: конечная точка / timestampinsecondssinceepoch / Zone

• Доступные ценовые зоны

• Получите 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?

• Сроки могут быть запрошены в секунды с момента эпохи
• Средняя цена за данный день предоставляется для классификации каждой цены в ежедневном контексте
• Проще в использовании конечных точек отдыха
• Автоматически обновляет и очищает данные (установите и забудьте)
• Открытый исходный код
• Отличное выступление, спасибо Дартию и Альфреду

Запустить свой собственный

Предварительные условия

• докер-состав

Настройка

• адаптировать среду в .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 .