NOTE for non-Finnish visitors: These pages are in Finnish, but API and Shelly-scripts support following countries in addition to Finland: Sweden, Norway, Denmark, Estonia, Latvia and Lithuania!
Api.spot-hinta.fi REST-rajapintojen tarkoitus on auttaa osaltaan energiakriisin selättämisessä, ohjaamalla sähkönkulutusta tunneille joissa kulutus ja tuotanto kohtaavat paremmin. Tarkoitus on myös saattaa älykäs kulutusohjaus useampien kuluttajien saataville.
Rajapinnat pyörivät Microsoft Azuressa luotettavalla ja skaalautuvalla Azure Functions alustalla. Rajapintoja on tarkoitus pyörittää pitkään tämän osoitteen kautta. Mikäli syystä tai toisesta näitä rajapintoja ei voida tarjota tästä osoitteesta, tullaan rajapinnan lähdekoodi julkaisemaan, jotta mahdollisuus rajapintojen käyttöön säilyy.
Rajapinnat ovat tarkoitettu taloautomaation yksityishenkilöiden toimesta, eikä rajapintoja saa käyttää kaupallisiin tarkoituksiin esimerkiksi jonkun kaupallisen palvelun taustalla. Rajapinnoissa on rajoitus max. 150 kyselyä tunnissa per IP osoite per rajapinta. Tämän ylittävä määrä palauttaa ”429-Too Many Requests”. IP-osoite voidaan myös estää kokonaan jos kyselyjä tehdään huomattavia määriä. Jos näin käy, IP osoitteen vapauttamista täytyy pyytää sähköpostitse.
Mahdolliset yhteydenotot rajapintoihin liittyen voi tehdä sähköpostilla: info(ät)spot-hinta.fi. Ota myös Twitter kanava seurantaan, niin saat tiedon muutoksista ja uusista ominaisuuksista.
| Rajapintojen kehitykseen ja ylläpitoon voit osallistua lahjoituksilla ”Buy Me a Coffee” palvelun kautta. Kiitos tuestasi! |  https://www.buymeacoffee.com/spothintafi |
Mukavia hetkiä taloautomaation parissa!
Tärkeitä linkkejä:
| Rajapintojen käyttämät tietolähteet | https://spot-hinta.fi/tietolahteet/ |
| Rajapintojen tekniset ”OpenAPI/Swagger” -kuvaukset | https://api.spot-hinta.fi/swagger/ui |
| Shelly releiden skriptit | https://spot-hinta.fi/shelly/ |
| Home Assistant yaml-koodit | https://spot-hinta.fi/home-assistant/ |
| Ohje itsepäivittyvälle HTML sivulle, joka näyttää sähkön hinnan nyt | https://spot-hinta.fi/html/ |