HealthCodes API
De bestanden downloaden, of niet
Je kunt de nomenclatuur gewoon downloaden. Voor een eenmalige analyse is dat de juiste keuze. Hier staat eerlijk waar de kosten zitten als het geen eenmalige analyse is.
In enkele minuten aan de slag. Maandelijks opzegbaar.
curl https://api.healthcodesapi.be/v1/source-status \
-H "Authorization: Bearer YOUR_API_KEY"Wat je krijgt als je downloadt
Een ZIP van ruim 60 MB met pipe-gescheiden tekstbestanden, plus een spreadsheet die de kolomindeling beschrijft. Uitgepakt is dat ongeveer 1,9 miljoen rijen verdeeld over tientallen tabellen die je zelf aan elkaar moet knopen.
Voor een eenmalige vraag — hoeveel codes bestaan er, wat kost verstrekking X — is dat prima. Een middag werk en je hebt je antwoord.
De drie plekken waar het misgaat
Bedragen gebruiken een punt als duizendtalscheiding. Een naïeve parse maakt van 1.694,42 € netjes 1,69 €, en het valt niet op tot iemand een factuur nakijkt.
De archieven dragen een timestamp uit 2018 ongeacht hun inhoud, dus je kunt niet aan HTTP zien of er iets veranderd is — je moet elke keer alles downloaden en vergelijken. En de tussentijdse wijzigingsbestanden verdwijnen na ongeveer vijf maanden van de site: mis je er één, dan is die historiek definitief weg.
Wanneer een API de goedkopere keuze is
Zodra het antwoord actueel moet blijven. Dan is de kost niet het parsen maar het onderhouden: elke publicatie opnieuw ophalen, verschillen detecteren, formaatwijzigingen opvangen, historiek bewaren. Dat is een paar dagen per jaar, elk jaar.
Wij bewaren elk archief byte voor byte met zijn SHA-256, zodat elk antwoord herleidbaar is tot het exacte bestand waaruit het komt. Dat is wat een download je niet geeft zonder het zelf te organiseren.
HealthCodes API is an independent developer service and is not affiliated with or endorsed by RIZIV/INAMI. Official publications remain authoritative.
Eenvoudige prijzen die meegroeien met uw toepassing.
Elk abonnement bevat beide talen, de volledige historiek en wijzigingsdetectie.