Met deze dienst kan je als organisatie automatisch meetgegevens ophalen uit jouw digitale meters en AMR- meters via een digitale koppeling (API). Je kan deze meetgegevens daarna eenvoudig toevoegen aan eigen toepassingen en gebruiken voor analyse, rapportage of energiebeheer.
Deze API is uitsluitend bedoeld voor professionele netgebruikers die hun eigen meetgegevens willen raadplegen. Gebruik deze API niet voor commerciële diensten, analyses of klantadviezen. Wil je dergelijke diensten aanbieden? Registreer je dan als energiedienstverlener en gebruik de bijbehorende API.
De API ontsluit zowel de gegevens van digitale meters als de meetgegevens van AMR-meters.
Toegang API
Toegang API
Hoe activeer je de toegang tot de API?
Stap 1: Meld je aan op Mijn Fluvius
Meld je aan op Mijn Fluvius met je professioneel account. Dit doe je met je eID of Itsme. Enkel personen gemachtigd om op te treden namens jouw organisatie kunnen zich aanmelden.
Meer informatie over inloggen met je professioneel account in Mijn Fluvius.
Stap 2: Activeer de API
Navigeer naar het menu. Klik daar op ‘Verbruiksdata opvolgen via API’. Neem de informatie door over de API en lees hoe je ermee aan de slag gaat. Activeer onderaan de pagina de toegang tot de API.
Toegang tot meetgegevens
Toegang tot meetgegevens
Hoe kan je toegang krijgen tot meetgegevens?
Stap 1
Voeg de betreffende meters toe in het overzicht van meters op Mijn Fluvius. Wil je weten hoe je een meter toevoegt om de meetgegevens op te vragen? Bekijk dan onderstaande video's:
Stap 2
Via API kan je de meetgegevens opvolgen van elke meter die in dit overzicht staat en waarvoor de toegang is goedgekeurd.
Goedkeuringen verlopen als volgt
- Eigen meters
Voor je eigen meters moet je eerst een toegangsaanvraag indienen via Mijn Fluvius. Fluvius keurt deze toegang automatisch goed als de organisatie die op Mijn Fluvius de aanvraag indient, hetzelfde KBO-nummer heeft als de organisatie die geregistreerd staat op het energiecontract.
→ Zodra de toegang via Mijn Fluvius is goedgekeurd voor je eigen meters, kan je via API de bijbehorende meetgegevens ophalen. - Dochterondernemingen of verwante ondernemingen
Voor meters van dochter- of verwante ondernemingen dien je ook een toegangsaanvraag in via Mijn Fluvius. Vervolgens vraagt Fluvius eerst toestemming aan de betrokken netgebruiker, namelijk de onderneming die op het energiecontract van de betreffende meter(s) geregistreerd staat. Fluvius keurt de toegang goed zodra de toegangsaanvraag is bevestigd door de betrokken netgebruiker.
→ Om meetgegevens van dochter- of verwante ondernemingen via API op te halen, is naast toegang via Mijn Fluvius, bijkomend ook nog een datatoegangscontract vereist (zie volgende tabblad).
Datatoegangscontract
Datatoegangscontract
Wanneer heb je een datatoegangscontract nodig?
Wil je via API niet enkel de meetgegevens van je eigen bedrijf, maar ook van verwante ondernemingen opvolgen? Dan moet je naast de toegang via Mijn Fluvius een datatoegangscontract afsluiten met Fluvius. Dit contract legt de wederzijdse verantwoordelijkheden vast bij werken met geautomatiseerde data van derde partijen.
Is een datatoegangscontract vereist, dan heb je twee opties:
- Onderteken het datatoegangscontract om toegang te krijgen tot de meetgegevens van aanverwante organisaties via API.
- Ga verder zonder het datatoegangscontract te ondertekenen: je kan dan enkel de meetgegevens van je eigen meters via API ophalen. Je hebt nadien nog altijd de optie om toch nog een datatoegangscontract af te sluiten.
Aan het afsluiten van een datatoegangscontract is een eenmalige kost verbonden. Meer informatie vind je in het document tarieven databeheer.
Op Mijn Fluvius kan je zonder datatoegangscontract altijd de meetgegevens van aanverwante organisaties raadplegen in grafieken en rapporten, op voorwaarde dat hiervoor toegang is verleend (zie ‘Hoe kan je toegang krijgen tot meetgegevens’).
Enkel voor geautomatiseerde processen, zoals een API, is bovenop deze toegang in Mijn Fluvius ook nog een datatoegangscontract met Fluvius vereist.
API gebruiken
API gebruiken
Hoe gebruik je de API?
Connectie met de API opzetten
De API gebruikt OAuth 2.0 Client Credentials Flow. Na activatie krijg je de nodige gegevens om te connecteren met de API. Met je credentials kan je een Bearer Token (JWT) ophalen, die jouw organisatie identificeert en bepaalt tot welke EAN-codes je toegang hebt. Gebruik deze token in de Authorization-header van al je API-aanvragen.
Je moet de toegangsgegevens jaarlijks hernieuwen. Ook bij elke wijziging van een datatoegangscontract moet je de toegangsgegevens hernieuwen.
Toegang tot de meetgegevens opvolgen via de API
Je kan je toegang tot meetgegevens raadplegen via het GET Mandate endpoint. Als de respons van de API aangeeft dat een bepaalde toegang is goedgekeurd (‘Approved’), dan kun je deze meetgegevens opvragen via het GET Energy endpoint.
Meetgegevens ophalen via API
Via de GET energy endpoint kan je meetgegevens opvragen. Je kiest daarvoor minstens de EAN-code, het detailniveau en de verbruiksperiode waarvoor je de gegevens wil opvragen.
Meer weten?
Alle informatie over API-gebruik voor professionele klanten vind je in deze handige PDF.
Heb je problemen met de API?
Vind je de oplossing voor je probleem niet in de documentatie? Neem contact op via het contactformulier. Vermeld duidelijk dat je vraag betrekking heeft op de API voor professionele gebruikers.