Initial API Proposal for Dedicated Networks

[tlohmar]

What type of PR is this?

Add one of the following kinds:

• enhancement/feature

What this PR does / why we need it:

This Pull Request provides an API specification for the Dedicated Networks API.

Which issue(s) this PR fixes:

Fixes #10

Special notes for reviewers:

Changelog input

 release-note

Additional documentation

This section can be blank.

docs

[eric-murray]

Hi @tlohmar

The filenames should be the same as the API name in the path. So dedicated-network-accesses.yaml, and so on.

This comes from the API design guidelines:

The API functionalities must be implemented following the specifications of the Open API version 3.0.3 using api-name as the filename and the .yaml or .json file extension.

[hdamker]

@tlohmar initial "version" of all three YAML files in main should be wip, the version in server url accordingly vwip
(the API version will be set only in release (PRs), all PRs in between must set it to wip. First alpha release will get 0.1.0-alpha.1, there is no such thing then a patch version of 0.0 :-))

See https://github.com/camaraproject/Commonalities/blob/main/documentation/API-design-guidelines.md#53-api-versions-throughout-the-release-process for more information