TweedeKamerDerStaten-Generaal / OpenDataPortaal

GitHub van het officiële Open Data Portaal van de Tweede Kamer der Staten-Generaal.
https://opendata.tweedekamer.nl
49 stars 3 forks source link

Documentatie beschikbaar maken volgens OpenAPI-specificatie (voorheen Swagger) #68

Open monty241 opened 2 years ago

monty241 commented 2 years ago

Het lukt me niet om in de documentatie terug te vinden of er een OpenAPI-specificatie is van de API's.

Mocht die er zijn: gelieve die een meer prominente plek te geven.

Mocht die er niet zijn: gelieve een OpenAPI-specificatie toe te voegen voor eenvoudiger ontsluiting. Het scheelt per API circa 1 mandag voor opname in Invantive Cloud / SQL.

De $metadata van OData is wel te vinden op https://gegevensmagazijn.tweedekamer.nl/OData/v4/2.0/.

OpenDataPortaal commented 2 years ago

Momenteel is er nog geen OpenAPI-specificatie (OAS) beschikbaar. We voegen dit toe aan de lijst met ontwikkelwensen. Zodra we een OAS hebben die we beschikbaar kunnen stellen publiceren we hierover op opendata.tweedekamer.nl en zullen we deze issue updaten.

svrooij commented 2 years ago

Ja OpenAPI bestanden zijn wel echt nodig.... Dat maakt het namelijk mogelijk om voor vrijwel elke taal een client te genereren zonder heel veel moeite.

Odata is niet iets dat heel veel mensen super goed beheersen. Met Swagger heb je tevens de mogelijkheid om in de browser direct dingen te proberen.

monty241 commented 2 years ago

Thx voor support. We hebben de $metadata nu verwerkt; zijn 151 tabellen (data model komt vanavond op https://documentation.invantive.com). Bevat wel veel informatie; erg luxe.

svrooij commented 2 years ago

Thx voor support. We hebben de $metadata nu verwerkt; zijn 151 tabellen (data model komt vanavond op https://documentation.invantive.com). Bevat wel veel informatie; erg luxe.

Dat is geen OpenAPI toch? En schijnbaar niet gemaakt door de ontwikkelaars van de API.

Ik hoop dat ze dit vanuit de overheid zelf gaan doen en niet een derde partij, waar het eerste wat je ziet een enorme cookiemelding is

OpenDataPortaal commented 10 months ago

We zijn bezig om de API's te laten voldoen aan de eisen zoals gesteld op developer.overheid.nl:

Onderdeel hiervan is het leveren van OAS.