RSGB Bevragingen Openbare Consultatie

KING nodigt u uit om deel te nemen aan de openbare consultatie voor de JSON API van de koppelvlakstandaard RSGB Bevragingen.

Tijdens de bijeenkomst van de regiegroep gegevens- en berichtstandaarden van 12 april jongstleden is de functionele specificatie en de XML/SOAP variant van de koppelvlakstandaard RSGB Bevragingen vastgesteld. De pilot RSGB bevragingen omvat, naast de XML/SOAP variant, ook een JSON-variant. Deze variant wordt nu aangeboden in een openbare consultatie. De JSON API wordt aangeboden via OPEN-API (Swagger). Functioneel voldoet deze API aan de koppelvlakspecificatie waarvan recentelijk de definitieve versie is gepubliceerd.

De consultatieprocedure voor de JSON variant van de koppelvlakstandaard RSGB bevragingen wijkt af van de gebruikelijke procedure:

• Aangezien de functionele beschrijving van dit koppelvlak reeds is vastgesteld is besloten om de consultatie van de JSON API te beperken tot drie weken.
• U wordt uitgenodigd om op 24 mei van 14:00 tot 16:30 deel te nemen aan een terugkoppelsessie betreffende de consultatie over deze JSON API. In deze terugkoppelsessie wordt ruimte geboden om over ingediende opmerkingen of commentaar te discussiëren. U kunt zich voor deze sessie aanmelden via Johan Boer.. De locatie wordt nog bepaald en verneemt u na aanmelding.
• Wij vragen een aantal partners op het gebied van standaardisatie die al meer ervaring hebben met JSON, om een review te doen op de gepubliceerde interface uit de pilot RSGB bevragingen. De resultaten van die review zullen we separaat zichtbaar maken in de consultatie en bij de behandeling in de komende regiegroep gegevens- en berichtenstandaarden.

Deze consultatie heeft betrekking op een eerste JSON uitwerking in de lijn “ontdekken” van de vernieuwing van onze standaarden.

• Het publieke endpoint van de API is te vinden op: http://stuf4.processfive.com
• De beperkte testset: http://stuf4.processfive.com/IngeschrevenPersoon/Test

Noot: De documentatie die in de API is aangeboden is gegenereerd met de open source tool “Swash Buckle”. Bij controle blijkt dat het opnemen van abstracttypes wel onderdeel is van Open API, maar nog niet breed wordt ondersteund door de tooling. De gegenereerde OPEN API documentatie wordt nog handmatig aangevuld. Het is gepland om die aanvullingen op 19 mei beschikbaar te stellen. Uiteraard zijn de JSON antwoordberichten wel opgesteld conform de documentatie van de koppelvlakspecificatie, dus tot die tijd kan voor de consultatie de koppelvlakspecificatie als referentie gehanteerd worden.

Partijen kunnen hun opmerkingen/verbetervoorstellen tot vrijdag 2 juni indienen bij Johan Boer.

Mochten er naar aanleiding van de antwoorden op uw reactie vragen zijn, dan horen wij dat graag.

Documentatie RSGB Bevragingen 1.0

Document	Metadata	Versie	Beschrijving	Versiedatum
Koppelvlakspecificatie RSGB bevragingenservices v 1.0.pdf (PDF-bestand, 2,75 MB)		1.0		Koppelvlakstandaarden		20170921

JavaScript Object Notation (JSON) is een lichtgewicht, op tekst gebaseerd, taalonafhankelijk gegevensuitwisselingsformaat.

Extensible Markup Language (XML) is een standaard van het World Wide Web Consortium voor de syntaxis van formele opmaaktalen waarmee men gestructureerde gegevens kan weergeven in de vorm van platte tekst.

Afkorting van 'application programming interface': een manier om twee of meer computerprogramma's met elkaar te laten communiceren. Het is een soort software-interface die een dienst aanbiedt aan andere stukjes software.

Het opleggen van een bepaalde norm of standaard voor het ontwerp, de constructie, het testen of gebruiken van een product of proces.

In de informatica is een interface een gedeelde grens waarover twee of meer afzonderlijke componenten van een computersysteem informatie uitwisselen. De uitwisseling kan plaatsvinden tussen software, computerhardware, randapparatuur, mensen en combinaties hiervan.