U bent hier

Nieuwe versie OData beschikbaar

dinsdag 26 juni 2018 - 09:00

Tekortkomingen aan het OData punt zijn inmiddels verbeterd en released onder een nieuwe versie. Er is besloten de v1 uit te faseren op 1 augustus 2018. Een overzicht van de OData end-points:

# URL OData versie API-data versie Opmerkingen
1 /OData/v3/1.0/ 3 (json + xml) 1.0 Veranderde structuur, verbeterde data kwaliteit en toegevoegde functionaliteiten t.o.v. v1.
X /OData/v1/ 3 (json + xml) 0.9 VERVALT per 01/08/2018

In plaats van https://gegevensmagazijn.tweedekamer.nl/OData/v1/ wordt er dus https://gegevensmagazijn.tweedekamer.nl/OData/v3/1.0/ gebruikt om gebruik te maken van XML. 

Veranderingen:

  • Data kwaliteit qua verwerking is verbeterd (We zijn nog bezig met valideren van data.)
    • Dubbele data onder Entiteiten is nu opgelost. (Voorheen werd er data soms niet verwijderd.)
    • Sommige relaties die wel in REST stonden ontbraken. Grootste verbeteringen:
      • Activiteit naar Reservering
      • Agendapunt naar Activiteit
      • Zaak naar Besluit
  • Mogelijkheid om Delta's op te halen. (Incrementeel de veranderingen binnenhalen per entiteit.)
  • Annotaties van partijen en Tweede Kamerleden zijn nu tevens beschikbaar. (Indien deze nog niet gekoppeld zijn door Redactie kunnen afnemers deze gebruiken.)
  • Er vervallen Entiteiten vanuit Verslag en Vergadering. Het bleek voor afnemers ondoenlijk te zijn de verslagen met expands op te halen. We streven ernaar om in de toekomst het gehele verslag in 1 keer op te kunnen halen als bestand. Zie de Verschillentabel voor meer uitleg.
  • De Entiteiten hebben allen de volgende kolommen:
    • Id: GUID die tevens in REST zit.
    • GewijzigdOp: datum wanneer het bronsysteem het laatst deze data heeft aangepast.
    • ApiGewijzigdOp: datum wanneer het is aangemaakt / veranderd in de OData Api. Dit maakt het mogelijk om delta's op te halen.
    • Verwijderd: Komt overeen met openbaar=false op entiteit niveau uit de REST. Er is bewust voor gekozen geen data te verwijderen uit OData als deze nog in de REST staat. Afnemers dienen hier zelf op te filteren.

Verschillentabel op entiteitniveau:

/V1/

/V3/1.0/

Activiteit

Activiteit

ActiviteitActor

ActiviteitActor

Agendapunt

Agendapunt

Besluit

Besluit

Bestand

Bestand

Commissie

Commissie

CommissieAanvullendGegeven

CommissieAanvullendGegeven

CommissieOrganisatie

CommissieOrganisatie

CommissieVastPersoon

CommissieVastPersoon

CommissieVastVacature

CommissieVastVacature

CommissieVervangerPersoon

CommissieVervangerPersoon

CommissieVervangerVacature

CommissieVervangerVacature

CommissieZetel

CommissieZetel

Fractie

Fractie

FractieAanvullendGegeven

FractieAanvullendGegeven

FractieLid

FractieLid

FractieOrganisatie

FractieOrganisatie

Kamerstuk

Kamerstuk

Kamerstukdossier

Kamerstukdossier

ParlementairDocument

ParlementairDocument

ParlementairDocumentActor

ParlementairDocumentActor

ParlementairDocumentVersie

ParlementairDocumentVersie

Persoon

Persoon

PersoonAdres

PersoonAdres

PersoonContactinformatie

PersoonContactinformatie

PersoonFunctie

PersoonFunctie

PersoonGeschenk

PersoonGeschenk

PersoonLoopbaan

PersoonLoopbaan

PersoonNevenfunctie

PersoonNevenfunctie

PersoonNevenfunctieInkomsten

PersoonNevenfunctieInkomsten

PersoonNevenfunctiePeriode

Zit nu in PersoonNevenfunctie

PersoonOnderwijs

PersoonOnderwijs

PersoonReis

PersoonReis

Reservering

Reservering

Stemming

Stemming

Vergadering

Vergadering

Verslag

Verslag (inclusief download link naar volledige XML)

VerslagActiviteit

-

VerslagActiviteitActiviteithoofd

-

VerslagActiviteitdeelActiviteitItem

-

VerslagActiviteitdeelHandeling

-

VerslagActiviteitHandeling

-

VerslagActiviteithoofdActiviteitdeel

-

VerslagActiviteithoofdHandeling

-

VerslagActiviteithoofdSprekerIndex

-

VerslagActiviteithoofdZaakIndex

-

VerslagActiviteitItemHandeling

-

VerslagActiviteitZaakIndex

-

VerslagBijlage

-

VerslagCategorie

-

VerslagDraadboekfragment

-

VerslagDraadboekfragmentSprekerIndex

-

VerslagDraadboekfragmentZaakIndex

-

VerslagHandeling

-

VerslagInterrumpantHandeling

-

VerslagSpreker

-

VerslagWoordvoerder

-

VerslagWoordvoerderHandeling

-

VerslagWoordvoerderInterrumpant

-

VerslagZaak

-

VerslagZaakSprekerIndex

-

Zaak

Zaak

ZaakActor

ZaakActor

Zaal

Zaal

Tags 
API Techniek