From 1af30536774a0872b180f6c74a3e4ed487218747 Mon Sep 17 00:00:00 2001 From: Eric Debeau Date: Tue, 14 May 2019 17:45:22 +0000 Subject: Integration with Swagger Correct doc8 errors Add licence in RST Add API table Add swaggerv2doc when OK Issue-ID: DCAEGEN2-1049 Change-Id: I7478b1c34625ce03ee4f1278a04a408f6f73718e Signed-off-by: Eric Debeau --- docs/sections/apis/configbinding.rst | 78 +++++------------------------------- 1 file changed, 11 insertions(+), 67 deletions(-) (limited to 'docs/sections/apis/configbinding.rst') diff --git a/docs/sections/apis/configbinding.rst b/docs/sections/apis/configbinding.rst index 85df2316..0b947dbf 100644 --- a/docs/sections/apis/configbinding.rst +++ b/docs/sections/apis/configbinding.rst @@ -1,24 +1,18 @@ -Config Binding Service 2.1.0 +Config Binding Service 2.2.3 ============================ .. toctree:: :maxdepth: 3 +.. csv-table:: + :header: "API name", "Swagger JSON", "Swagger YAML" + :widths: 10,5,5 - - - -DEFAULT -~~~~~~~ - - - + "Config Binding Service", ":download:`link `", ":download:`link `" GET ``/service_component_all/{service_component_name}`` ------------------------------------------------------- - - Description +++++++++++ @@ -34,13 +28,11 @@ Parameters :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" :widths: 20, 15, 10, 10, 10, 20, 30 - service_component_name | path | Yes | string | | | Service Component Name. service_component_name must be a key in consul. - + service_component_name | path | Yes | string | | | Service Component Name. service_component_name must be a key in consul. Request +++++++ - Responses +++++++++ @@ -49,14 +41,10 @@ Responses OK; returns {config : ..., policies : ....., k : ...} for all other k in Consul - .. _i_4d863967ef9a9d9efdadd1b250c76bd6: **Response Schema:** - - - **Example:** .. code-block:: javascript @@ -68,16 +56,9 @@ OK; returns {config : ..., policies : ....., k : ...} for all other k in Consul there is no configuration in Consul for this component - - - - - GET ``/service_component/{service_component_name}`` --------------------------------------------------- - - Description +++++++++++ @@ -93,13 +74,11 @@ Parameters :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" :widths: 20, 15, 10, 10, 10, 20, 30 - service_component_name | path | Yes | string | | | Service Component Name. service_component_name must be a key in consul. - + service_component_name | path | Yes | string | | | Service Component Name. service_component_name must be a key in consul. Request +++++++ - Responses +++++++++ @@ -108,12 +87,8 @@ Responses OK; the bound config is returned as an object - **Response Schema:** - - - **Example:** .. code-block:: javascript @@ -125,16 +100,9 @@ OK; the bound config is returned as an object there is no configuration in Consul for this component - - - - - GET ``/{key}/{service_component_name}`` --------------------------------------- - - Description +++++++++++ @@ -150,14 +118,12 @@ Parameters :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" :widths: 20, 15, 10, 10, 10, 20, 30 - key | path | Yes | string | | | this endpoint tries to pull service_component_name:key; key is the key after the colon - service_component_name | path | Yes | string | | | Service Component Name. - + key | path | Yes | string | | | this endpoint tries to pull service_component_name:key; key is the key after the colon + service_component_name | path | Yes | string | | | Service Component Name. Request +++++++ - Responses +++++++++ @@ -166,13 +132,8 @@ Responses OK; returns service_component_name:key - - **Response Schema:** - - - **Example:** .. code-block:: javascript @@ -182,24 +143,17 @@ OK; returns service_component_name:key **400** ^^^^^^^ -bad request. Currently this is only returned on :policies, which is a complex object, and should be gotten through service_component_all - +bad request. Currently this is only returned on :policies, which is a complex +object, and should be gotten through service_component_all **404** ^^^^^^^ key does not exist - - - - - GET ``/healthcheck`` -------------------- - - Description +++++++++++ @@ -207,11 +161,9 @@ Description This is the health check endpoint. If this returns a 200, the server is alive and consul can be reached. If not a 200, either dead, or no connection to consul - Request +++++++ - Responses +++++++++ @@ -220,16 +172,8 @@ Responses Successful response - **503** ^^^^^^^ the config binding service cannot reach Consul - - - - -Data Structures -~~~~~~~~~~~~~~~ - -- cgit 1.2.3-korg