From e1308ace3df3de1efc204db1e9eac05a72b75c22 Mon Sep 17 00:00:00 2001 From: lukegleeson Date: Thu, 30 Sep 2021 13:36:37 +0100 Subject: Update Design & Modeling Sections Update both Design and Modeling sections of Cps-Core Documentation Issue-ID: CPS-626 Change-Id: I7b42e0bcedbec8d973557140c503828e33239847 Signed-off-by: DylanB95EST Signed-off-by: lukegleeson --- docs/design.rst | 24 +++++++++++++++++++----- 1 file changed, 19 insertions(+), 5 deletions(-) (limited to 'docs/design.rst') diff --git a/docs/design.rst b/docs/design.rst index f9f12de432..ce419caedf 100755 --- a/docs/design.rst +++ b/docs/design.rst @@ -9,8 +9,6 @@ CPS Design ########## -.. warning:: draft - .. toctree:: :maxdepth: 1 @@ -23,8 +21,8 @@ CPS supports the public APIs listed in the link below: :download:`CPS NCMP RestOpenApi Specification ` -Exposed API ------------ +View Offered APIs +----------------- The standard for API definition in the RESTful API world is the OpenAPI Specification (OAS). The OAS 3, which is based on the original "Swagger Specification", is being widely used in API developments. @@ -33,7 +31,23 @@ Specification can be accessed using following URI: .. code-block:: bash - “http://:/v3/api-docs?group=cps-docket” + http://:/v3/api-docs?group=cps-docket + +Additionally, the Swagger User Interface can be found at the following URI. The component may be changed between CPS-Core +and CPS-NCMP using the drop down table in the top right: + +.. code-block:: bash + + http://:/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/ + +Consumed APIs +------------- + +CPS Core uses API's from the following ONAP components + +* DMI-Plugin: REST based interface which is used to provide integration + and allow the DMI registry API's have access to the corresponding NCMP API's within CPS Core. + More information on the DMI Plugins offered APIs can be found on the `DMI Plugin's Design Page `_. CPS Path ======== -- cgit 1.2.3-korg