API for mĂ„lerverdier – tilgjengelig i pilot nĂ„!

Vi i Elvia har fÄtt forespÞrsler fra bÄde private kunder og tredjepartsaktÞrer om Ä fÄ tilgang til mÄlerverdier, sÄ vi har nÄ i en pilot publisert et mÄlerverdi-API som gir deg som er privatkunde tilgang til dine data.

I denne piloten har vi publisert et mÄlerverdi-API for at du som privatkunde skal kunne fÄ tilgang til dine data, og du kan i tillegg gi din smarthusleverandÞr tilgang pÄ dine vegne, hvis du Þnsker det. Erfaringene fra denne fÞrste versjonen skal vi bruke til Ä lage en god og enklere lÞsning for deling med parter du Þnsker at skal fÄ tilgang til dine data.

Vi vil gjerne ha dine tilbakemeldinger pÄ problemer, erfaringer eller forslag til forbedringer. Kontakt oss pÄ pilot@elvia.no (kundesenteret til Elvia kan dessverre ikke svare pÄ tekniske spÞrsmÄl om APIer).


Her er noen viktige punkter om mÄlerverdi-APIet:

  • Vi er i en pilot og tjenesten kan dermed vĂŠre ustabil. Vi vil gjerne ha dine tilbakemeldinger pĂ„ pilot@elvia.no

  • APIet gir kun tilgang for privatkunder (enn sĂ„ lenge).

  • For tilgang til data (se link til guide nederst) utsteder du et personlig «token». Den gir kun tilgang til de mĂ„lerne som du har eierskap til. Det er viktig Ă„ huske pĂ„ at tokenet er personlig, og at du ikke mĂ„ gi det til noen du ikke stoler pĂ„. Du kan ogsĂ„ enkelt slette tokenet pĂ„ Min side.

  • Tokenet (ogsĂ„ kalt AccessToken) gir tilgang til dine forbruksdata (og produksjon for plusskunder) og du kan gjĂžre hva du vil med det, men husk Ă„ behandle det med varsomhet og gi det kun fra deg til for eksempel smarthusleverandĂžrer du stoler pĂ„ og har et kundeforhold til.

  • Dersom du gir tokenet til en ekstern part, for eksempel en smarthusleverandĂžr, sĂ„ opptrer de pĂ„ vegne av deg, og Elvia har ikke noe ansvar for hvordan den parten behandler dine data. De er i dette tilfellet ikke en databehandler for Elvia og Elvia er ikke en behandlingsansvarlig. Se evt Kapittel 1 i personopplysningsloven pĂ„ lovdata.no dersom du vil lese mer om dette.

  • Dersom du velger Ă„ slette tokenet pĂ„ Min side pĂ„ elvia.no, sĂ„ husk at du mĂ„ be om sletting av dine data hos eventuelle eksterne parter som du har gitt tokenet til, dersom du Ăžnsker at disse dataene skal slettes.

Hvordan fungerer metervalue-APIet?

  • APIet («MeterValueApi») gir ut metervalues (timesforbruk eller timesproduksjon) eller maxhours(de timene med maks forbruk pr mnd) i den tidsperioden du ber om, men begrenset til maksimalt 1 Ă„rs mĂ„lerverdier pr kall, og maksimalt 3 Ă„r tilbake i tid.

  • AccessToken – du utsteder et token pĂ„ Min side pĂ„ elvia.no. Tokenet kan brukes som nĂžkkel i kallet mot APIet. Tokenet er personlig og mĂ„ kun deles med de du stoler pĂ„. Det kan enkelt slettes pĂ„ Min side.

    Her er en guide til hvordan du tar i bruk APIet.