API | VEKA energieAttesten |
|---|---|
Doel | Gegevens over een (historisch) ingediend energieprestatiecertificaat opzoeken en uitlezen |
Locatie | Testomgeving: https://energie-ti-secure.api.vlaanderen.be/energie-attesten-api/v1/energie-attesten |
Toegang | Voor overheden, lokale besturen, … op basis van een vooraf afgesloten protocol en ontsloten via een PKI-certificaat Er worden nog geen aansluitingsaanvragen op de testomgeving of productieomgeving behandeld of aanvaard. Zodra dat wel mogelijks is, zal de procedure hier opgenomen worden. |
Technische informatie | https://github.com/OVO000090/VEKA_REST_API/blob/main/docs/energie-attesten-uat-v1.md https://github.com/OVO000090/VEKA_REST_API/blob/main/docs/energie-attesten-prod-v1.md |
Implementatie
Deze API is ontwikkeld voor externe partijen die informatie betreffende ingediende energieattesten nodig hebben in kader van het realiseren van een welomschreven doeleinde, dat vooraf werd vastgelegd in een protocol en een verwerkersovereenkomst met het Vlaams Energie- en Klimaatagentschap (VEKA).
Het is een private API waarbij externe partijen specifiek de toestemming nodig hebben om toegang te verkrijgen.
In het kader van onderlinge afspraken tussen de afnemer en VEKA rond data-uitwisseling, gespecifieerd in het protocol, is het mogelijk dat een afnemer niet alle informatie beschreven in dit document kan consulteren. Het VEKA kan immers per afnemer verdere filtering toepassen.
Security van de webservices
De web services (REST APIs) voor het melden van centrale stooktoestellen zijn niet publiek beschikbaar. De API vereist gebruik van certificaten voor het tot stand brengen van mutual TLS. Zo kan zowel de client als de server de identiteit van de andere partij valideren.
Meer informatie rond het opzetten van mutual TLS is vrij te vinden op het internet.