OpenAPIs development guidelines

From NFVwiki
Revision as of 12:36, 20 September 2017 by Carignani (talk | contribs)

OpenAPI developement guidelines for ETSI NFV SOL working group.

API development

General guidelines

Root API files

Since the specification requires the apiVersion be after apiName in the resource path, each interface will have a separate OpenAPI root file.

In details, paths are required to start with:

<apiRoot>/<apiName>/<apiVersion>

the only way to model this with OAS is using separate files for each interface. This will also help readability and clarity.

Repositories

Guidelines on the creation and usage of repositories will be available in this section.

Folder structure

Guidelines on the folder structure for each repository will be available in this section.

Links and contacts

List of repositories

Name Content Manager Link Review link
NFV Overall materials, examples, documentation ETSI CTI https://forge.etsi.org/rep/gitweb.cgi/NFV.git https://forge.etsi.org/gerrit/#/q/project:nfv


If you are willing to contribute or if you want more information, contact ETSI CTI.