Misschien een beetje ‘off topic’ (want geen geo…) maar ik post mijn vraag toch maar hier, omdat de Open API Specification (OAS) ook gebruikt wordt voor het documenteren van de REST API’s van PDOK.
Een paar maanden geleden heeft de provincie Zuid-Holland de website https://subsidieregister.zuid-holland.nl in de lucht gebracht. Voor het ophalen van de gegevens uit de achterliggende database is een API ontwikkeld. Die API ben ik nu aan het documenteren met behulp van SwaggerHub. Voor mij de eerste keer dat ik zoiets doe. Zie Build, Collaborate & Integrate APIs | SwaggerHub
Mijn eerste vraag is: Is SwaggerHub handig? Wat is naar jullie idee de beste tooling?
Het array deel van de vraag kan ik wel beantwoorden met een linkje naar Data Types . De Arrays sectie zou voldoende informatie moeten bevatten om je specificatie te corrigeren.
Nee, nog niet. Maar dat ben ik wel van plan. Ik heb al gezien dat de API-strategie hele bruikbare aanwijzingen geeft voor de doorontwikkeling van de subsidieregister API of het opzetten van nieuwe API’s. Dankjewel!
