From 8f141d17f3ea7720df479f4ae51b5a2e169548cb Mon Sep 17 00:00:00 2001 From: romaingimbert Date: Fri, 14 Sep 2018 14:52:20 +0200 Subject: Add API Documentation for Casablanca -update docs -update version related code -change properties MSB Change-Id: I7fb2a257ec035c53e93666d7571a2c74a0624524 Issue-ID: EXTAPI-141 Signed-off-by: romaingimbert --- docs/offeredapis/offeredapis.rst | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) mode change 100755 => 100644 docs/offeredapis/offeredapis.rst (limited to 'docs/offeredapis/offeredapis.rst') diff --git a/docs/offeredapis/offeredapis.rst b/docs/offeredapis/offeredapis.rst old mode 100755 new mode 100644 index c2d1cdd..4ecfdd9 --- a/docs/offeredapis/offeredapis.rst +++ b/docs/offeredapis/offeredapis.rst @@ -25,7 +25,7 @@ Following illustration provides a global view about nbi architecture,integration API Version *********** -APIs are described with a state version with “v” following the API Name, e.g.: 'nbi/api/v1/productOrder'. +APIs are described with a state version with “v” following the API Name, e.g.: 'nbi/api/v3/productOrder'. The schema associated with a REST API must have its version number aligned with that of the REST API. The version number has major, minor and revision numbers. E.g. v1.0.0 @@ -74,11 +74,12 @@ API Table :widths: 10,5,5,5,5,5,5 " ", "json file", "html doc", "plantUML doc", "Swagger Editor", "Postman Collection", "pdf doc" - "serviceCatalog", ":download:`link `", ":download:`link `", ":download:`link `", "coming", "coming", "coming" - "serviceInventory", ":download:`link `", ":download:`link `", ":download:`link `", "coming", "coming", "coming" - "serviceOrder", ":download:`link `", ":download:`link `", ":download:`link `", "coming", ":download:`link `", "coming" - + "serviceCatalog", ":download:`link `", ":download:`link `", ":download:`link `", "coming", "coming", "coming" + "serviceInventory", ":download:`link `", ":download:`link `", ":download:`link `", "coming", "coming", "coming" + "serviceOrder", ":download:`link `", ":download:`link `", ":download:`link `", "coming", ":download:`link `", "coming" + "listener", ":download:`link `", ":download:`link `", ":download:`link `", "coming", "coming", "coming" + *************** API Description *************** @@ -100,7 +101,7 @@ Only ‘basic’ service characteristics will be managed in this release. By ‘ GET serviceSpecification(list) -(example: GET /nbi/api/v1/serviceSpecification/?category=NetworkService&distributionStatus=DISTRIBUTED) +(example: GET /nbi/api/v3/serviceSpecification/?category=NetworkService&distributionStatus=DISTRIBUTED) It is possible to retrieve a list of serviceSpecification (get by list). @@ -110,7 +111,7 @@ if no serviceSpecification matches, an empty list is send back. GET tservice Specification (id) -(example: GET /nbi/api/v1/serviceSpecification/{uuid}) +(example: GET /nbi/api/v3/serviceSpecification/{uuid}) It is use to retrieve one serviceSpecification - all available information are retieved (see swagger for description) @@ -126,7 +127,7 @@ This API retrieves service(s) in the AAI inventory. Only following attributes wi GET Service Inventory (list): -(example: GET /nbi/api/v1/service/?relatedParty.id=Pontus +(example: GET /nbi/api/v3/service/?relatedParty.id=Pontus ) GET (by list) allows to request with following criteria (all optional) : @@ -145,7 +146,7 @@ if no service matches, an empty list is send back. GET Service Inventory (id): -(example: GET /nbi/api/v1/service/{uuid} but customerId & serviceSpecification.id must passed in requested parameters) +(example: GET /nbi/api/v3/service/{uuid} but customerId & serviceSpecification.id must passed in requested parameters) Because of AAI capability, additionally to the service id, customer id and [serviceSpecification.id or serviceSpecification.name] must be supplied. If the customer id is not supplied, External API will use ‘generic’ customer -- cgit 1.2.3-korg