VNG-Realisatie / ODS-Open-Raadsinformatie

Project repository tbv de ontwikkeling van de Open Raads- en Stateninformatie API specificatie
https://vng-realisatie.github.io/ODS-Open-Raadsinformatie/
11 stars 2 forks source link

Discussie: aantal netwerkcalls bij bevragen van vergaderinformatie door PLOOI en andere afnemers - wat is acceptabel of gewenst? #103

Open hdksi opened 3 months ago

hdksi commented 3 months ago

De (mini-)ORI API is ontworpen om per API-call niet meer data dan nodig te bevragen. Resources (vergaderingen, agendapunten en informatieobjecten) zijn primair met behulp van URL's aan elkaar gerelateerd. Dit is conceptueel heel netjes, maar betekent wel dat het ophalen van een 'complete' vergadering (dus met bijbehorende agendapunten en informatieobjecten) relatief veel netwerkcalls met zich mee kan brengen.

Bijvoorbeeld:

  1. vergadering ophalen op basis van {id}
  2. agendapunt 1 ophalen via teruggekregen url
  3. agendapunt 2 ophalen via teruggekregen url
  4. agendapunt 3 ophalen via teruggekregen url
  5. agendapunt n ophalen via teruggekregen url
  6. informatieobjecten 1,2,3,[...] ophalen via teruggekregen {id's}

Een alternatief voor vergaderingen en agendapunten lijkt die altijd/alleen te bevragen met query parameter 'gewijzigdSinds'. Dan zouden altijd twee calls nodig zijn - voor iedere resource één. Informatieobjecten kunnen vervolgens op basis van id's in één extra call worden opgehaald.

Wat is hier gewenst?