API | VEKA Meldingen API (OpenAPI specificaties) |
---|---|
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 (aanvraag: locatie aanvraagformulier) en ontsloten via een PKI-certificaat |
Technische informatie | (link naar github) |
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.
Testomgeving
VEKA voorziet een test-versie van de API om de implementatie door de softwareleverancier te faciliteren. Er zijn twee versies beschikbaar: één beveiligde API en één publiek toegankelijke. Beide APIs bevatten dezelfde logica.
Toegang tot de Meldingen API kan aangevraagd worden via: Toegang voor softwareleveranciers
Test API | Beveiligde versie |
---|---|
Authenticatie | Test certificaat |
Locatie | https://energie-ti-secure.api.vlaanderen.be/meldingen-api-a2a/v1/extern/meldingCentraleStooktoestellen |
Test API | Publieke versie |
---|---|
Authenticatie | Geen |
Locatie | https://energie-ti.api.vlaanderen.be/meldingen-api-a2a/v1/extern/meldingCentraleStooktoestellen |