Simple Edge discovery API method parameters do not use lower camel case as in the rest of CAMARA APIs

[sergiofranciscoortiz]

Similarly to the issue #151, we have noticed that apart from resource names, method attributes/parameters in Simple Edge Discovery API do not follow lower camel case naming.

Although it is apparently not strictly indicated in API Design Guidelines, it is defined to use camel case convention in several items and somehow hints to use it generally.

Furthermore it seems to be the widely use in other published CAMARA APIs as for example in BlockchainPublicAddress API, where the use phoneNumber as parameter for the method.

The suggestion is to adapt all paramaters to lower camel case notation, that would include:

Current Parameter Name	Suggested lower camel case name
IP-Address	ipAddress
Network-Access-Identifier	networkAccessIdentifier
Phone-Number	phoneNumber

[Kevsy]

HI @sergiofranciscoortiz -

This is raised in Commonalities issue 105 in order to achieve consistency across all APIs.

I will add to that to issue to suggest that the guidelines need to explicitly define syntax for POST parameters (the link above only refers to path parameters, and querystring parameters are mentioned above it, but nothing explicit on POST (non-URL) parameters)

[sergiofranciscoortiz]

OK thanks, we can wait for the outcome of the discussion in commonalities.

[Kevsy]

Updated the Commonalities issue as the Simple Edge Discovery API provides Device Identifiers as Headers (for which Uppercase-hyphen is the de facto standard).

[Kevsy]

Now raised as PR 120 in Commonalities

If approved, then I will update the Simple Edge Discovery API to import those definitions.

[Kevsy]

Outcome: agreed in Commonalities that Upper-kebab-case is appropriate for HTTP headers