Introductie
De Tweede Kamer genereert veel parlementaire data. Denk hierbij aan wetsvoorstellen, moties, amendementen, verslagen en de samenstelling van fracties en commissies. De Tweede Kamer verzamelt al deze parlementaire data in het Gegevensmagazijn. Via de API's van het Open Data Portaal heb je toegang tot de data in het Gegevensmagazijn. Deze data kan je bijvoorbeeld gebruiken voor onderzoek of het ontwikkelen van applicaties.
In deze documentatie lees je hoe je data over het parlementaire proces kan ophalen uit het Gegevensmagazijn van de Tweede Kamer. Het Open Data Portaal biedt twee mogelijkheden aan om dit te doen: een OData API en een SyncFeed API.
De API's
De data in het Gegevensmagazijn zijn toegankelijk via twee API's: de OData API en de SyncFeed API. Een API (Application Programming Interface) maakt het mogelijk om data uit te wisselen tussen verschillende systemen.
Veel van de data in het Gegevensmagazijn zijn ook beschikbaar op de website van de Tweede Kamer. Het verschil tussen de website van de Kamer en het Open Data Portaal is dat je met het Open Data Portaal sneller en gerichter kan zoeken, en de resultaten breder kan toepassen.
De OData API en SyncFeed API gebruik je voor verschillende doeleinden:
| API | Beschrijving | Link naar documentatie |
|---|---|---|
| OData API | Hiermee kan je zoeken naar specifieke data. Met verschillende entiteiten, attributen en filters maak je zelf een zoekvraag in de vorm van een URL. | OData documentatie |
| SyncFeed API | Hiermee kan je (een deel van) de data uit het Gegevensmagazijn synchroniseren met een eigen database. | Syncfeed documentatie |
De database
De database waarmee de API's verbonden zijn, is een cloudkopie van een database die binnen de Tweede Kamer wordt gebruikt: het Gegevensmagazijn. In het Gegevensmagazijn komen de ruwe data uit verschillende applicaties die het parlementaire proces ondersteunen samen en worden deze, waar mogelijk, relationeel opgeslagen. Dat houdt in dat er logische verbanden tussen de data uit de verschillende applicaties wordt gelegd, waardoor het makkelijk wordt data te combineren en analyseren.
De cloudkopie van het Gegevensmagazijn is vrijwel identiek aan het interne Gegevensmagazijn. Alleen in de volgende gevallen verschillen de databases van elkaar:
- Wanneer data nog getest en gedocumenteerd moeten worden voordat ze naar de cloud kunnen gaan;
- Wanneer data in de cloud van andere labels zijn voorzien om de gebruiksvriendelijkheid te verbeteren;
- Wanneer data zonder externe relevantie niet worden doorgestuurd naar de cloud om ruis te voorkomen.
Gebruik het informatiemodel om inzicht te krijgen in de informatiehuishouding van de Tweede Kamer. Ontdek welke data er in het Open Data Portaal beschikbaar zijn en hoe deze onderling samenhangen.
De bronsystemen
De bronsystemen bevatten data vanaf het moment dat de bijbehorende applicaties in gebruik zijn genomen. De volgende vier bronsystemen leveren data aan het Gegevensmagazijn:
| Bronsysteem | Datum ingebruikneming | Beschrijving |
|---|---|---|
| Parlis | 01-09-2008 | Het parlementair informatiesysteem waarin de Griffies van de Tweede Kamer activiteiten plannen, documenten delen en stemmingsuitslagen registreren ter ondersteuning van het werk van de Tweede Kamerleden. |
| Sesam | 01-09-2021 | Het actorensysteem waarin gegevens over Tweede Kamerleden, fracties en commissies worden opgeslagen. |
| VLOS | 25-06-2013 | Het verslaglegging ondersteunend systeem waarin de verslagen van vergaderingen worden gemaakt. |
| Toezeggingenregistratie | 01-09-2022 | Het registratiesysteem waarin toezeggingen die bewindspersonen aan Tweede Kamerleden doen worden bijgehouden. |
Naast de bovenstaande bronsystemen is er ook een koppeling met het Kennis- en Exploitatiecentrum Officiële Overheidspublicaties (KOOP). Deze 'KOOP-koppeling' zorgt voor een verbinding met officielebekendmakingen.nl. Hierdoor zijn zowel de metadata als de bestandsformaten van de site ook beschikbaar in het Gegevensmagazijn.
Voorwaarden voor het gebruik van de API's
Om het gebruik van de API's voor iedereen toegankelijk te maken en een stabiele verbinding te garanderen, is er een disclaimer opgesteld met mededelingen die van toepassing zijn op het gebruik van de API's. Het wordt aanbevolen om regelmatig de geldende versie van de disclaimer te lezen.
Lees hier de disclaimer van het Open Data Portaal.
Vragen
Heb je na het lezen van deze documentatie nog vragen? Kijk eerst bij de veelgestelde vragen of neem anders contact op.