search

kadaster / klic-win

https://kadaster.nl/zakelijk/registraties/landelijke-voorzieningen/klic
20 stars 16 forks source link

Toepassen nieuwe hostname/base-url voor KLIC-API's #94

Closed herman-vandenberg closed 6 months ago

herman-vandenberg commented 4 years ago

Het Kadaster heeft een nieuwe richtlijn uitgegeven voor de naamgeving van de 'hostname' voor door Kadaster beheerder API's. Voor KLIC zou dit betekenen dat KLIC-API's worden gehost op: https://api.klic.kadaster.nl. Daarnaast is het gewenst om de "base-url", het pad dat gebruikt wordt na de hostname voor de verschillende API-diensten binnen KLIC, ook te vereenvoudigen en te uniformeren. Daarbij willen we wél de gedragsregels zoals deze beschreven zijn als nationale API-richtlijn (en toegepast bij o.a. DSO) respecteren. In later commentaar volgt een overzicht van de momenteel gebruikt paden en de voorgestelde nieuwe paden voor de verschillende API-endpoints.

herman-vandenberg commented 3 years ago

Kadaster heeft de intentie om breed gebruik te maken van een API-portal. Aangezien op deze API-portal momenteel nog niet de authenticatie/autorisatie-instellingen geïmplementeerd zijn die we voor KLIC nodig hebben, gebruiken we voor deze diensten eerst nog het "service10"-toegangspad. Voor het opvragen van KLIC-waardelijsten gaat al wél van de portal gebruik gemaakt worden. Zie hieronder: image

JustinRoodenburg commented 3 years ago

De endpoints van versie 2 worden gecommuniceerd op de Kadaster Github van KLIC: https://github.com/kadaster/klic-win/blob/master/API%20management/Overzicht%20endpoints%20KLIC%20APIs.md