cps-rest/docs/openapi/cpsQueryV2.yml

   1 #  ============LICENSE_START=======================================================
   2 #  Copyright (C) 2023 TechMahindra Ltd.
   3 #  ================================================================================
   4 #  Licensed under the Apache License, Version 2.0 (the "License");
   5 #  you may not use this file except in compliance with the License.
   6 #  You may obtain a copy of the License at
   7 #
   8 #        http://www.apache.org/licenses/LICENSE-2.0
   9 #
  10 #  Unless required by applicable law or agreed to in writing, software
  11 #  distributed under the License is distributed on an "AS IS" BASIS,
  12 #  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 #  See the License for the specific language governing permissions and
  14 #  limitations under the License.
  15 #
  16 #  SPDX-License-Identifier: Apache-2.0
  17 #  ============LICENSE_END=========================================================
  18
  19 nodesByDataspaceAndAnchorAndCpsPath:
  20   get:
  21     description: Query data nodes for the given dataspace and anchor using CPS path
  22     tags:
  23       - cps-query
  24     summary: Query data nodes
  25     operationId: getNodesByDataspaceAndAnchorAndCpsPathV2
  26     parameters:
  27       - $ref: 'components.yml#/components/parameters/dataspaceNameInPath'
  28       - $ref: 'components.yml#/components/parameters/anchorNameInPath'
  29       - $ref: 'components.yml#/components/parameters/cpsPathInQuery'
  30       - $ref: 'components.yml#/components/parameters/descendantsInQuery'
  31     responses:
  32       '200':
  33         description: OK
  34         content:
  35           application/json:
  36             schema:
  37               type: object
  38             examples:
  39               dataSample:
  40                 $ref: 'components.yml#/components/examples/dataSample'
  41       '400':
  42         $ref: 'components.yml#/components/responses/BadRequest'
  43       '401':
  44         $ref: 'components.yml#/components/responses/Unauthorized'
  45       '403':
  46         $ref: 'components.yml#/components/responses/Forbidden'
  47       '500':
  48         $ref: 'components.yml#/components/responses/InternalServerError'
  49     x-codegen-request-body-name: xpath
  50
  51 nodesByDataspaceAndCpsPath:
  52   get:
  53     description: Query data nodes for the given dataspace across anchors using CPS path
  54     tags:
  55       - cps-query
  56     summary: Query data nodes across anchors
  57     operationId: getNodesByDataspaceAndCpsPath
  58     parameters:
  59       - $ref: 'components.yml#/components/parameters/dataspaceNameInPath'
  60       - $ref: 'components.yml#/components/parameters/cpsPathInQuery'
  61       - $ref: 'components.yml#/components/parameters/descendantsInQuery'
  62       - $ref: 'components.yml#/components/parameters/pageIndexInQuery'
  63       - $ref: 'components.yml#/components/parameters/pageSizeInQuery'
  64     responses:
  65       '200':
  66         description: OK
  67         content:
  68           application/json:
  69             schema:
  70               type: object
  71             examples:
  72               dataSample:
  73                 $ref: 'components.yml#/components/examples/dataSampleAcrossAnchors'
  74       '400':
  75         $ref: 'components.yml#/components/responses/BadRequest'
  76       '401':
  77         $ref: 'components.yml#/components/responses/Unauthorized'
  78       '403':
  79         $ref: 'components.yml#/components/responses/Forbidden'
  80       '500':
  81         $ref: 'components.yml#/components/responses/InternalServerError'
  82     x-codegen-request-body-name: xpath