VNG-Realisatie / gemma-zaken

Samen ontwikkelen van API's voor Zaakgericht werken
https://vng-realisatie.github.io/gemma-zaken/
Other
41 stars 27 forks source link

[VRAAG] Wat doet datumGeldigheid query param op Zaaktype detail endpoint? #2391

Open joeribekker opened 10 months ago

joeribekker commented 10 months ago

A query param was added to the detail API endpoint for zaaktypen, in Catalogi API 1.3, to filter on datumGeldigigheid.

This happens here, in the code: https://github.com/VNG-Realisatie/catalogi-api/pull/176/files#diff-20d4d24fb5eb822147f2a94d6bf56da472670100290e7cecb76f0330079d3f80R186-R194 and this line in the changelog https://github.com/VNG-Realisatie/catalogi-api/blob/a75aeb570cb7250d68ad1a34d66956518a9e1e58/CHANGELOG.rst?plain=1#L35

Presumably because of this ticket: https://github.com/VNG-Realisatie/gemma-zaken/issues/1838 but I can't make out what this change should do. Can someone explain?

image

HenriKorver commented 9 months ago

@michielverhoef of @johannesbattjes: hebben jullie een antwoord op bovenstaande vraag van Joeri?

johannesbattjes commented 9 months ago

Nee ik zie niet direct een link met mijn oorspronkelijke vraag in genoemd issue (heb alleen niet de hele discussie herlezen).

joeribekker commented 9 months ago

Ik dacht dat dat ticket relevant was omdat datumGeldigheid dan bijvoorbeeld bepaalde statustypen (die nu ook door dat ticket een datumGeldigheid hebben) eventueel zou filteren? Maar geen idee precies.

michielverhoef commented 8 months ago

Om op te kunnen vragen welke versie van een zaaktype op een bepaald moment geldig is kun je een query doen met zaaktype.omschrijving en datumGeldigheid.

Bijvoorbeeld welke versie van de MOR Melding is geldig op 21-02-2024.

Hiermee wordt het mogelijk dat een consumer de juiste versie van het zaaktype op kan vragen zonder dat de exacte url naar die versie bekend is. Bij die versie van het zaaktype horen dan inderdaad ook de juiste statustypen, roltypen, eigenschappen etc.