From fb7389919fb7e0e038267773c102f1cad4b9df71 Mon Sep 17 00:00:00 2001 From: lapentafd Date: Fri, 14 Apr 2023 10:05:26 +0100 Subject: [PATCH] Fix offeredapi documentation Deleted repeted lines. Fixed missing body in Post requests in the generated swagger pages, added OpenApi 3 support. Issue-ID: POLICY-4581 Change-Id: Id7558efeb210457e4e9c79df5e6e155d1525d3d4 Signed-off-by: lapentafd --- docs/conf.py | 15 +++++++++++---- docs/offeredapis.rst | 10 ++-------- 2 files changed, 13 insertions(+), 12 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 367166bf..a43b3055 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -27,13 +27,14 @@ extensions = [ 'sphinxcontrib.redoc' ] +redoc_uri = 'https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js' + redoc = [ { 'name': 'Policy API', 'page': 'api/local-swagger', 'spec': 'https://raw.githubusercontent.com/onap/policy-api/master/main/src/main/resources/openapi/openapi.yaml', 'opts': { - 'lazy-rendering': True, 'suppress-warnings': True, 'hide-hostname': True, } @@ -43,7 +44,6 @@ redoc = [ 'page': 'pap/local-swagger', 'spec': 'https://raw.githubusercontent.com/onap/policy-pap/master/main/src/main/resources/openapi/openapi.yaml', 'opts': { - 'lazy-rendering': False, 'suppress-warnings': True, 'hide-hostname': True, } @@ -53,7 +53,15 @@ redoc = [ 'page': 'xacml/local-swagger', 'spec': 'https://raw.githubusercontent.com/onap/policy-xacml-pdp/master/main/src/main/resources/openapi/openapi.yaml', 'opts': { - 'lazy-rendering': False, + 'suppress-warnings': True, + 'hide-hostname': True, + } + }, + { + 'name': 'Policy DROOLS', + 'page': 'drools/local-swagger', + 'spec': 'https://raw.githubusercontent.com/onap/policy-drools-pdp/master/feature-healthcheck/src/main/resources/openapi/openapi.yaml', + 'opts': { 'suppress-warnings': True, 'hide-hostname': True, } @@ -63,7 +71,6 @@ redoc = [ 'page': 'clamp/acm/api-protocol/local-swagger', 'spec': 'https://raw.githubusercontent.com/onap/policy-clamp/master/runtime-acm/src/main/resources/openapi/openapi.yaml', 'opts': { - 'lazy-rendering': False, 'suppress-warnings': True, 'hide-hostname': True, } diff --git a/docs/offeredapis.rst b/docs/offeredapis.rst index a9e34cc2..6bf3a6bd 100644 --- a/docs/offeredapis.rst +++ b/docs/offeredapis.rst @@ -53,9 +53,9 @@ OAS 3.0 is used to describe the API contracts, and those documents are added as `Swagger Specification for Policy XACML-PDP <./xacml/local-swagger.html>`_ -`Swagger Specification for Policy ACM-R <./clamp/acm/api-protocol/local-swagger.html>`_ +`Swagger Specification for Policy DROOLS-PDP <./drools/local-swagger.html>`_ -`Swagger Specification for Policy DROOLS-PDP `_ +`Swagger Specification for Policy ACM-R <./clamp/acm/api-protocol/local-swagger.html>`_ The YAML document can be also downloaded and imported in an web editor such as `Editor Swagger `_ @@ -67,9 +67,3 @@ An "OpenApi first" approach is adopted, so starting from the Swagger document we For Example ACM-Runtime endpoint ``http://:/onap/policy/clamp/acm/v3/api-docs`` - - The Swagger document can still be extracted from the code in the API that uses *Spring-Doc* dependency at the endpoint "../v3/api-docs/" - For Example ACM-Runtime endpoint - - ``http://:/onap/policy/clamp/acm/v3/api-docs`` - -- 2.16.6