Conventie naamgeving voor API's

[ehotting]

In de API strategie staat summier iets over de naamgeving van resources, API-07 en API-08 *).

Conventies voor naamgeving van API's zijn ook nuttig. De eerste vragen hierover dienen zich aan. Is er verschil tussen CRUD data API's en API's die business rules ontsluiten? Hoe zorgen we voor een zekere uniciteit in naamgeving?

*) API-07 Definitie van het koppelvlak is in het Nederlands tenzij er sprake is van een officieel Engelstalig begrippenkader
API-08 Resource namen zijn zelfstandige naamwoorden in het meervoud

[GeertJohan]

Google api design docs bevatten een aantal nuttige punten:
Service names: https://cloud.google.com/apis/design/naming_convention#service_names
Interface names: https://cloud.google.com/apis/design/naming_convention#interface_names

[jasperroes]

Voorstel werkgroep: in design rules opnemen dat over API naamgeving is niets over afgesproken (inclusief API principe). We verwijzen mogelijk wel naar bestaande documenten voor nuttig advies als je zelf niet iets logisch kunt verzinnen.

[jasperroes]

Verwerkt in design rules hoofdstuk, pull request aangemaakt om te mergen.