search

VNG-Realisatie / klantinteracties

Project repository tbv de ontwikkeling van de Klantinteracties API specificatie
https://vng-realisatie.github.io/klantinteracties/
1 stars 4 forks source link

Als gemeente wil ik geen properties met de typeaanduiding in de naam #166

Open erikdelepper opened 3 years ago

erikdelepper commented 3 years ago

Zodat de api’s beter leesbaar zijn en property namen beter overeenkomen met internationale standaarden.

Zo als websiteUrl, we zeggen immer ook geen voornaamString of UUID als id.

michielverhoef commented 3 years ago

Hier komen we nog op terug maar kun je aangeven om welke eniteiten en attributen het gaat?

Overigens, UUID kennen we nu wel en hier is bewust voor gekozen omdat dit een technisch ID is en geen identificatie zoals het identificatie veld beschreven in het RGBZ. Het is misschien wat ongelukkig gekozen maar de vraag is hoe storend het is. Welke ontwikkelaar heeft er moeite mee?

Het attribuut websiteUrl bevat misschien een type aanduiding maar aan de andere kant zie ik dit zelf wel als een verduidelijking. Het is in ieder geval geen typeaanduiding als string, integer of iets dergelijks.

Tenzij je op een gegeven moment ook dingen zou willen doen als een base-64 encoded blob van een qr-code in een attribuut website opslaan maar of dat nou handig is?

erikdelepper commented 3 years ago

websiteUrl staat in de klant-API. Als je een website registreert, lijkt het me logisch dat je dan een URL bedoelt. Wat mij betreft heeft dit geen hoge prio, maar hij viel me op.

hdksi commented 2 years ago

Checken tegen bekende standaarden (schema.org/anders).