summaryrefslogtreecommitdiffstats
path: root/docs/MultiCloud-K8sPlugin-APIv1-Specification.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/MultiCloud-K8sPlugin-APIv1-Specification.rst')
-rw-r--r--docs/MultiCloud-K8sPlugin-APIv1-Specification.rst26
1 files changed, 26 insertions, 0 deletions
diff --git a/docs/MultiCloud-K8sPlugin-APIv1-Specification.rst b/docs/MultiCloud-K8sPlugin-APIv1-Specification.rst
new file mode 100644
index 0000000..24dd1ef
--- /dev/null
+++ b/docs/MultiCloud-K8sPlugin-APIv1-Specification.rst
@@ -0,0 +1,26 @@
+..
+ This work is licensed under a Creative Commons Attribution 4.0
+ International License.
+
+=========================================
+MultiCloud K8sPlugin API v1 Specification
+=========================================
+
+The is the specification for MultiCloud K8sPlugin API version v1.
+
+API Swagger
+===========
+
+The specification of the K8sPlugin v1 API in Swagger format:
+
+:download:`k8splugin-v1-api-swagger.json <k8splugin/k8splugin-v1-api-swagger.json>`
+
+API Catalog
+===========
+
+.. warning::
+ In the used Sphinx plugin `sphinxcontrib-swaggerdoc` some information of the swagger file is not
+ rendered completely, e.g. the request body. Use your favorite Swagger Editor and paste the swagger file
+ to get a complete view of the API reference, e.g. on https://editor.swagger.io/.
+
+.. swaggerv2doc:: k8splugin/k8splugin-v1-api-swagger.json