Spot-hinta.fi – Pikakoodit
”Pikakoodit” on Spot-hinta.fi palvelun yksinkertainen toiminnallisuus, jossa voit hyödyntää valmiiksi suunniteltuja ohjauksia pörssihintojen mukailuun. Pikakoodeja voi käyttää Shelly älyreleiden ohjaamiseen hyvin pienellä skriptillä, mikä tekee skriptin parametroinnin todella helpoksi.
Lisäksi pikakoodeja voi käyttää hyvin yksinkertaisen ”GET”-rajapinnan avulla melkein mistä vain vimpaimesta. Näin sinun ei tarvitse miettiä mistä haet pörssihinnat tai miten käsittelet niitä koodissasi. Yksi yksinkertainen GET-kutsu voi tehdä paljon asioita puolestasi.
Shelly-skripti
Voit asentaa pikakoodeille pienen Shelly pikakoodi-skriptin käyttämällä Shellyn kirjasto toiminnallisuutta. Käytä kirjastossa osoitteena tätä osoitetta: https://api.spot-hinta.fi/shelly/scripts
Voit kopioida skriptin myös suoraan Githubista: https://github.com/Spot-hinta-fi/Shelly/blob/main/Scripts/Shelly-Pikakoodi.js
Kun olet asentanut skriptin Shellyyn, voit katsoa alla olevasta taulukosta sinulle parhaiten sopivan toiminnallisuuden pikakoodin, mikä asetetaan skriptissä yhteen parametriin. Ohjauksen asetus ei siis juuri voisi helpompaa olla. Skriptin alku näyttää tältä ja korostettu kohta on, mihin pikakoodi asetetaan.
Jos listalta ei löydy sinulle sopivaa ohjausta, voit tehdä monenlaisia todella älykkäitä ohjauksia muilla Spot-hinta.fi skripteillä. Ja tietenkin voit esittää ehdotuksia, millaisia ohjauksia kaipaisit pikakoodeihin, niin ohjaus voidaan ehkä lisätä listalle. Ehdotukset voi esittää sähköpostilla osoitteeseen: info (at) spot-hinta.fi
REST-rajapinta
Pikakoodeja voi käyttää yksinkertaisen ”GET” rajapinnan kautta. Rajapinta palauttaa HTTP statuskoodin ”200” jos ehto täyttyy ja ”400” jos ehto ei täyty. Kysely on hyvin yksikertainen ja muotoa: https://api.spot-hinta.fi/QuickCode/<pikakoodi>, esimerkiksi: https://api.spot-hinta.fi/QuickCode/100
Yhdestä IP-osoitteesta voi tehdä noin 150 kutsua tunnissa rajapintaan. Sen ylittävät määrät palauttavat koodin 429 (Too Many Requests).
Pikakoodit:
Valitse näistä koodeista sopivin Shelly-skriptiisi tai REST-rajapintakutsuusi.
| Pikakoodi | Tyypillinen käyttökohde | Ohjauksen kuvaus |
|---|---|---|
| 100 | Lämminvesivaraaja | Salli lämmitys vuorokauden kaikista halvin tunti (yksi tunti) |
| 101 | Lämminvesivaraaja | Salli lämmitys vuorokauden 2 halvinta tuntia |
| 102 | Lämminvesivaraaja | Salli lämmitys vuorokauden 3 halvinta tuntia |
| 103 | Lämminvesivaraaja | Salli lämmitys vuorokauden 4 halvinta tuntia |
| 110 | Lämminvesivaraaja | Salli lämmitys yöajan kaikista halvin tunti (yksi tunti). Yöaika on 22:00 – 06:59. |
| 111 | Lämminvesivaraaja | Salli lämmitys yöajan 2 halvinta tuntia. Yöaika on 22:00 – 06:59. |
| 112 | Lämminvesivaraaja | Salli lämmitys yöajan 3 halvinta tuntia. Yöaika on 22:00 – 06:59. |
| 113 | Lämminvesivaraaja | Salli lämmitys yöajan 4 halvinta tuntia. Yöaika on 22:00 – 06:59. |
| 125 | Lämmitys | Salli lämmitys vuorokauden 10 halvimman tunnin ajaksi |
| 126 | Lämmitys | Salli lämmitys vuorokauden 12 halvimman tunnin ajaksi |
| 127 | Lämmitys | Salli lämmitys vuorokauden 14 halvimman tunnin ajaksi |
| 128 | Lämmitys | Salli lämmitys vuorokauden 16 halvimman tunnin ajaksi |
| 129 | Lämmitys | Salli lämmitys vuorokauden 18 halvimman tunnin ajaksi |
| 130 | Lämmitys | Salli lämmitys vuorokauden 20 halvimman tunnin ajaksi |
| 140 | Hintarajaohjaus | Salli ohjaus jos sähkön hinta (alv. 24%) on 0 senttiä tai alle |
| 145 | Hintarajaohjaus | Salli ohjaus jos sähkön hinta (alv. 24%) on 5 senttiä tai alle |
| 150 | Hintarajaohjaus | Salli ohjaus jos sähkön hinta (alv. 24%) on 10 senttia tai alle |
| 155 | Hintarajaohjaus | Salli ohjaus jos sähkön hinta (alv. 24%) on 15 senttia tai alle |
| 160 | Hintarajaohjaus | Salli ohjaus jos sähkön hinta (alv. 24%) on 20 senttia tai alle |
| 200 | Hintarajaohjaus | Salli ohjaus jos sähkön hinta (alv. 24%) on alle päivän keskiarvohinnan |
| 210 | Peräkkäiset tunnit | Salli ohjaus vuorokauden 2 halvimman peräkkäisen tunnin aikana |
| 211 | Peräkkäiset tunnit | Salli ohjaus vuorokauden 3 halvimman peräkkäisen tunnin aikana |
| 212 | Peräkkäiset tunnit | Salli ohjaus vuorokauden 4 halvimman peräkkäisen tunnin aikana |
| 213 | Peräkkäiset tunnit | Salli ohjaus vuorokauden 5 halvimman peräkkäisen tunnin aikana |
Mukavaa pörssiohjailua!
Jos haluat, voit tukea Spot-hinta.fi palvelua täällä