search

Geonovum / KP-APIs

26 stars 40 forks source link

API-03 verwijzing naar PATCH methode in plaats van formaat? #349

Closed kad-baanh closed 1 year ago

kad-baanh commented 4 years ago

Bij API-03 wordt de HTTP PATCH methode uitgelegd met een verwijzing naar rfc5789 (uit 2010). Ook in de bijlage A References staat dit vermeld.

Ik vraag me af wat de toegevoegde waarde hier van is in het kader van de design rules? Alleen de PATCH methode krijgt ook een dergelijke toelichting.

Wat ik mis is de vermelding van het te gebruiken MergePatch formaat bij deze HTTP PATCH, zie https://tools.ietf.org/html/rfc7386. Zou hier over nagedacht kunnen worden?

mrtn78 commented 2 years ago

de toelichting op patch verplaatsen naar de voetnoot in normatieve regel API-03

MergePatch zou ik eerst als extensie uitwerken. nagaan bij de werkgroep van @HenriKorver wat hierover al onderzocht en beschreven is.

mrtn78 commented 1 year ago

Dit issue is verwerkt in https://github.com/Logius-standaarden/API-Design-Rules/pull/130 en wordt naar verwachting meegenomen in de volgende release