EnergieAttesten API
- Johan De Clercq
- Bram Devreese
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 Aansluitingsaanvragen kunnen gericht worden naar privacy.veka@vlaanderen.be Eventueel met een reeds ingevuld protocol |
Technische informatie | VEKA_REST_API/docs/energie-attesten-uat-v1.md at main · OVO000090/VEKA_REST_API VEKA_REST_API/docs/energie-attesten-prod-v1.md at main · OVO000090/VEKA_REST_API |
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) 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.