gemma-zaken icon indicating copy to clipboard operation
gemma-zaken copied to clipboard

Als developer wil ik resources kunnen filteren op meerdere waardes

Open stevenbal opened this issue 4 years ago • 3 comments

Zodat bijvoorbeeld Statussen gefiltered kunnen worden met een lijst van mogelijke zaak-urls.

Dit zou er bijvoorbeeld zo uit kunnen zien: https://zaken-api.vng.cloud/api/v1/statussen?zaak=[{{zaak_url1}},{{zaak_url2}}]

gerelateerd aan: https://github.com/VNG-Realisatie/gemma-zaken/issues/1469

stevenbal avatar Mar 30 '20 15:03 stevenbal

De vraag is even of we wel op deze manier de status op willen vragen of dat dit niet beter anders moet. Dit is een design issue wat voor alle API's op dezelfde manier opgelost moet worden.

Er zijn andere mogelijkheden als:

  • Per zaak kun je de status opvragen, wil je de status van meerdere zaken weten doe je meerdere aanroepen. Filteren gebeurt dus op 1 waarde.
  • Maak een convenience API die een dergelijke call voor de gebruiker afschermt en een eenvoudige aanroep biedt, dit is overigens een onderwerp waar nog een ei over gelegd moet worden. De aanroep uit dit voorbeeld valt nog wel mee maar het zou een eerste stap kunnen zijn op weg naar gebruiksvriendelijkere API's. Hiermee maak je het wel mogelijk dat de systeem API's veranderen zonder dat de convenience API voor de gebruiker verandert. Voor de consumers wordt het leven dus aangenamer.

Er zijn ongetwijfeld nog andere argumenten en oplossingsrichtingen te verzinnen @HenriKorver en @joeribekker .

michielverhoef avatar Mar 31 '20 08:03 michielverhoef

ZIe ook #1586

Hugo-ter-Doest avatar Apr 20 '20 07:04 Hugo-ter-Doest

Maak een convenience API die een dergelijke call voor de gebruiker afschermt en een eenvoudige aanroep biedt, dit is overigens een onderwerp waar nog een ei over gelegd moet worden.

Dit geeft je wel nog steeds een performance penalty. Ja, voor de consumer wordt het 1 call, maar als die 3 zaaktypen filtert, dan worden het 3 achterliggende calls, en de resultaten moeten ook weer correct samengevoegd worden.

Het is efficienter om dat in 1 call te ondersteunen.

sergei-maertens avatar May 08 '20 08:05 sergei-maertens