HealthCodes API
RIZIV-codes zoeken en opzoeken
Op nummer als je het kent, op tekst als je het niet kent. Het antwoord zegt altijd waaróm iets matchte.
curl https://api.healthcodesapi.be/v1/search?q=raadpleging&lang=nl \
-H "Authorization: Bearer YOUR_API_KEY"Zoeken op tekst werkt in het Nederlands
De bron publiceert elke omschrijving in het Nederlands en het Frans, en wij doorzoeken ze allebei. `?lang=nl` beperkt tot het Nederlands wanneer je weet in welke taal je gebruiker typt.
Accenten doen er niet toe: wie `radiografie` typt vindt hetzelfde als wie `radiografieën` typt. Dat klinkt vanzelfsprekend tot je het zelf moet bouwen op een bestand waarin de tekst als Latin-1 staat.
Elk resultaat zegt hoe zeker het is
Resultaten dragen een `match_type`: `exact_code`, `code_prefix`, `exact_text`, `text_prefix`, `relevance` of `fuzzy`. Een exacte codetreffer mag je blind tonen; een fuzzy treffer wil je als suggestie tonen en niet als antwoord.
Dat onderscheid is het verschil tussen een zoekveld dat vertrouwen wekt en één dat af en toe met veel zelfvertrouwen de verkeerde code invult op een factuur.
De structuur waarin een code leeft
Elke code hangt in een boom: 11 hoofdstukken, 49 artikels, 3.255 subartikels en 84 sectoren. Die structuur is opvraagbaar als index én per knoop, zodat je een bladerbare navigatie kunt bouwen in plaats van alleen een zoekveld.
Voor code 101076 is dat Hoofdstuk II, artikel 2, subartikel 2B, raadplegingen in de spreekkamer. Een gebruiker die dat ziet, weet meteen of hij in de juiste buurt zit.
Eenvoudige prijzen die meegroeien met uw toepassing.
Elk abonnement bevat beide talen, de volledige historiek en wijzigingsdetectie.