Het API-register op developer.overheid.nl bestaat al een aantal jaar. Maar lang niet alle API’s van de overheid staan erin. En dat is jammer. Dus bedacht het team van developer.overheid.nl samen met data.overheid.nl een eenvoudige manier om alle API’s uit data.overheid.nl naar het API-register te halen. Dimitri van Hees van developer.overheid.nl vertelt erover.
‘Op data.overheid.nl staan alle datasets van de overheid. De metadata van die datasets liggen vast in DCAT. Maar ontwikkelaars, de voornaamste doelgroep van developer.overheid.nl, willen informatie over API’s. En die kunnen ze niet makkelijk vinden in DCAT. Daarom hebben wij een vertaling gemaakt van DCAT naar JSON, waardoor de gegevens over API’s automatisch in het API-register terecht kunnen komen.’
Nieuw DCAT-profiel
Daarvoor moeten aanbieders van datasets wel de nieuwe versie van DCAT gebruiken, die net is uitgekomen. ‘In dat nieuwe DCAT-profiel zit namelijk de mogelijkheid om API’s mee te nemen. Als aanbieders dat nieuwe profiel gebruiken en hun API’s daarmee beschrijven, dan hoeven ze verder niets te doen.’
Werken bij de bron
‘Kijk, ik begrijp best dat aanbieders niet uit eigen beweging naar het API-register toe gaan om daar hun API aan te melden. Er is ook geen wettelijke verplichting om dat te doen. Maar het is wel logisch om API’s op één centrale plek te registreren. Want het wordt steeds belangrijker voor ontwikkelaars om dicht bij de bron te werken. Leuker kunnen we het niet maken voor aanbieders om hun API op dat register te krijgen. Maar wel makkelijker.’
Automatische test
‘Wij zorgen ervoor dat aanbieders er iets voor terugkrijgen als hun API in ons register staat: de API’s worden automatisch getest of ze aan de geldende standaarden voldoen. En als-dat niet zo is, dan geven we een terugkoppeling aan aanbieders hoe ze het probleem kunnen oplossen. En zo zijn we druk bezig met nog een aantal nieuwe features.’
Niet meer grasduinen
‘Het is een misverstand dat alle datasets een API hebben. Ook is het niet zo dat alle API’s over datasets gaan. Maar als het ons lukt om op deze manier alle API’s uit data.overheid.nl naar het API-register te trekken, dan scheelt dat een hoop werk. Gebruikers hoeven dan niet meer te grasduinen in allerlei verschillende registraties. Zo maken we data van de overheid beter toegankelijk voor ontwikkelaars.’
