strom_api

strom_api

Um programa RESTful versátil que agrega e serve dados por hora para os preços da eletricidade .

Basta executar este servidor, e ele fará todo o levantamento pesado para você.

Países suportados

Espanha (PVPC)

• Fonte de dados: API Redata
• O servidor buscará automaticamente os dados de preço para o dia seguinte, todos os dias às 20:30 (horário do Madri).

Exemplos

Automação residencial

• Use como fonte de dados na automação residencial para tomar decisões com base no preço atual de energia
• Consulte OpenHab_Example/strom_update.js (você precisará criar os itens referenciados antes)

Pontos finais de repouso

• Esquema Geral: Endpoint / TimestampinsecondsSsSsSsSsSsssinceEpoch / Zone

• Zonas de preço disponíveis

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

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

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

• Obtenha 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 é o registro de data e hora em ambos os casos. 0 sempre retornará o preço atual na hora local da zona solicitada.

• Documentação detalhada do terminal

Por que devo usar este servidor em outra API?

• Os prazos podem ser solicitados em segundos desde a época
• A média de preço do dia em determinado é fornecida para classificar cada preço no contexto diário
• Mais fácil de usar pontos de extremidade de descanso
• Atualizações e limpa os dados automaticamente (defina e esquece)
• Código aberto
• Ótimo desempenho, graças a Dart e Alfred

Execute o seu próprio

Pré -requisitos

• Docker-Compose

Configure

• Adapte o ambiente em .env , consulte * .env.example
• Não mude TZ
• Rating_margin é um valor de margem em porcentagem para classificação de preços. Padrões para 10, o que significa que apenas preços 10% abaixo da média diária serão considerados fora do pico. Deve estar entre 0 e 99.

Configurar

• execute ./deploy.sh
• A porta padrão é 3001. Parabéns . Agora você tem um strom_api em execução nesta porta. Pode ser facilmente proxado reverso, se necessário.

Atualização

• A execução ./deploy.sh sempre reconstruirá o ramo principal deste repositório e reiniciará o contêiner

Desenvolvimento

Executar testes

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

Simular ações do GitHub

• act --secret-file my.secrets

Gerar documentos

• dart doc .