Hur fungerar Boverkets API för energideklarationer?
Boverkets API är utvecklat för att företag lättare ska kunna få tillgång till vissa uppgifter i energideklarationsregistret som behövs i deras verksamhet. Dessa begränsade uppgifter kallas för basuppgifter.
Basuppgifter
Följande basuppgifter kan hämtas för en byggnad:
- energiklass,
- energideklarations-ID,
- energiprestanda (primärenergital),
- specifik energianvändning (det som tidigare var energiprestanda),
- om radonmätning och ventilationskontroll är utförd, samt
- när energideklarationen är utförd.
REST API
REST-API:et har bara en funktion – att hämta information om energideklarationer. För att använda denna funktion:
- använder du en GET-metod, vilket betyder att du ber om att få information.
- måste du ange vilken kommun du är intresserad av.
- måste du också ange antingen fastighetsbeteckningen eller adressen för byggnaden.
Exempel på anrop (notera att detta är fiktiva data):
GET https://api.boverket.se/energideklarationer/?kommun=Stockholm
&fastighetsbeteckning=HELGEANDSHOLMEN%201
Svaret returneras i form av en JSON-fil, se exempel nedan:
"energideklarationer": [{
"id": 123456789,
"energiklass": "E",
"primarenergital": "216 kWh/m² och år",,
"energiprestanda": "130 kWh/m² och år",
"radonmatning": "Inte utförd",
"ventilationskontroll": "Utförd",
"byggnadsar": null,
"utford": "2021-01-01",
"fastigheter": [{
"kommun": "Stockholm",
"fastighetsbeteckning": "HELGEANDSHOLMEN 1",
"adresser": [{
"adress": "Riksgatan 1",
"postnummer": "11128",
"postort": "Stockholm"
}]
Vad är ett REST-API?
Ett REST-API är ett gränssnitt som möjliggör kommunikation mellan olika program och tjänster över internet. Det använder HTTP-protokollet och standardiserade metoder (som GET, POST, PUT, DELETE) för att utföra operationer på resurser. Boverkets API för energideklarationer har endast en GET-metod för att hämta information om energideklarationer
Begränsningar
Det finns begränsningar för antalet anrop respektive användare av API:t kan genomföra. Dessa är satta till:
- 10 anrop per 2 sekunder
- 1500 anrop per dygn
- 40 000 kilobyte data per dygn
Löpande servicefönster
Varje morgon mellan klockan 06:00 och ca 06:15 uppdateras API:ets databas med ny information. Under denna tid levererar inte API:et någon information om energideklarationerna.