Merge remote-tracking branch 'madpah/fix/openapi-schema-errors' into feat/domain-objects

Author: ppkarwasz

Diff for: spec/generators/common.yaml

@@ -1,4 +1,4 @@
-inputSpec: /local/spec/openapi.json
+inputSpec: /local/spec/openapi.yaml
 gitUserId: CycloneDX
 gitRepoId: transparency-exchange-api
 

Diff for: spec/openapi.yaml

@@ -7,7 +7,7 @@ info:
   description: TBC
   contact:
     name: TEA Working Group
-    email: TBC
+    email: [email protected]
     url: https://github.com/CycloneDX/transparency-exchange-api
   license:
     name: Apache 2.0
@@ -17,81 +17,82 @@ servers:
   - url: http://localhost/tea/v1
     description: Local development
 paths:
-  "/product/uuid/{uuid}":
+  /product/uuid/{uuid}:
     get:
       description: Returns the corresponding leafs for a given product UUID.
       operationId: getTeaProductByUuid
       parameters:
-        - "$ref": "#/components/parameters/tei_urn"
+        # @todo
+        - $ref: "#/components/parameters/tei_urn"
       responses:
-        '200':
+        200:
           description: Requested TEA Product found and returned
           content:
             application/json:
               schema:
-                "$ref": "#/components/schemas/product"
-        '404':
-          "$ref": "#/components/responses/404-object-by-id-not-found"
+                $ref: "#/components/schemas/product"
+        400:
+          $ref: "#/components/responses/400-invalid-request"
+        404:
+          $ref: "#/components/responses/404-object-by-id-not-found"
       tags:
         - TEA Product
-  "/product/type/{type_identifier}":
+  /product/{product-identifier-type}/{product-identifier}:
     get:
       description: Returns a list of TEA products. Note that multiple products may
         match.
-      operationId: ProductByIdentifier
+      operationId: getTeaProductByIdentifier
       parameters:
-        - name: type_identifier
-          description: The identifier type (enum)
-          in: path
-          required: true
-          schema:
-            "$ref": "#/components/schemas/identifier"
-        - name: type_val
-          description: The actual identifier string
-          in: query
-          required: true
-          schema:
-            type: string
+        - $ref: "#/components/schemas/identifier_type"
+        - $ref: "#/components/parameters/product-identifier"
+        - $ref: "#/components/parameters/page-offset"
+        - $ref: "#/components/parameters/page-size"
       responses:
-        '200':
+        200:
           description: Product retrieved successfully
-          content:
-            application/json:
-              schema:
-                "$ref": "#/components/responses/paginated_product_list"
-        "$ref": "#/components/responses/standard_errors"
-  "/leaf/{tea_leaf_identifier}":
+          $ref: "#/components/responses/paginated-product"
+        400:
+          $ref: "#/components/responses/400-invalid-request"
+        404:
+          $ref: "#/components/responses/404-object-by-id-not-found"
+      tags:
+        - TEA Product
+  /leaf/{leaf-identifier}:
     get:
       description: Get the TEA Leaf that describes the Version of a Product
-      operationId: getTeaLeaf
+      operationId: getTeaLeafById
       parameters:
-        - "$ref": "#/components/parameters/tea_leaf_identifier"
+        - $ref: "#/components/schemas/uuid"
       responses:
-        '200':
+        200:
           description: Requested TEA Leaf found and returned
           content:
             application/json:
               schema:
                 "$ref": "#/components/schemas/component"
-        '404':
-          "$ref": "#/components/responses/404-object-by-id-not-found"
+        400:
+          $ref: "#/components/responses/400-invalid-request"
+        404:
+          $ref: "#/components/responses/404-object-by-id-not-found"
       tags:
         - TEA Leaf
-  "/collection/{tea_collection_identifier}":
+  /collection/{collection-identifier}:
     get:
       description: Get a TEA Collection by it's Identifier
-      operationId: getTeaCollection
+      operationId: getTeaCollectionById
       parameters:
-        - "$ref": "#/components/parameters/tea_collection_identifier"
+        - $ref: "#/components/schemas/uuid"
       responses:
-        '200':
+        200:
           description: Requested TEA Collection found and returned
           content:
             application/json:
               schema:
-                "$ref": "#/components/schemas/collection"
-        '404':
-          "$ref": "#/components/responses/404-object-by-id-not-found"
+                "$ref": "#/components/schemas/tea_collection"
+        400:
+          $ref: "#/components/responses/400-invalid-request"
+        404:
+          $ref: "#/components/responses/404-object-by-id-not-found"
       tags:
         - TEA Collection
 webhooks: {}
@@ -469,72 +470,37 @@ components:
         - BLAKE2b-512
         - BLAKE3
   responses:
-    base_error:
-      type: object
-      description: Error message
-      properties:
-        error:
-          type: string
-        message:
-          type: string
-    404-object-by-id-not-found:
-      description: Object requested by identifier not found
+    204-common-delete:
+      description: Object deleted successfully
+      content:
+        application/json: {}
+    400-invalid-request:
+      description: Request was Invalid
       content:
         application/json: {}
     401-unauthorized:
       description: Authentication required
       content:
         application/json: {}
-    pagination_details:
-      type: object
-      description: Pagination details
-      properties:
-        timestamp:
-          type: string
-          format: date-time
-          example: '2024-03-20T15:30:00Z'
-        page_start_index:
-          type: number
-          format: int64
-          default: 0
-        page_size:
-          type: number
-          format: int64
-          default: 100
-        total_results:
-          type: number
-          format: int64
-      required:
-        - timestamp
-        - page_start_index
-        - page_size
-        - total_results
-    paginated_product_list:
-      type: object
-      description: List of Products
-      allOf:
-        - $ref: "#/components/responses/pagination_details"
-        - type: object
-          properties:
-            products:
-              type: array
-              items:
-                $ref: "#/components/schemas/product"
-    standard_errors:
-      description: Standard error codes
-      '400':
-        description: Invalid request body
-        content:
-          application/json: {}
-      '401':
-        "$ref": "#/components/responses/401-unauthorized"
-      '404':
-        "$ref": "#/components/responses/404-object-by-id-not-found"
-    standard_delete:
-      description: Delete response
-      '204':
-        description: Resource successfully deleted
+    404-object-by-id-not-found:
+      description: Object requested by identifier not found
+      content:
+        application/json: {}
+    paginated-product:
+      description: A paginated response containing TEA Products
+      content:
+        application/json:
+          schema:
+            allOf:
+              - $ref: "#/components/schemas/product"
+              - type: object
+                properties:
+                  results:
+                    type: array
+                    items:
+                      "$ref": "#/components/schemas/product"
   parameters:
+    # Pagination
     page-offset:
       name: page-offset
       description: Pagination offset
@@ -553,86 +519,50 @@ components:
         type: number
         format: int64
         default: 100
-    tei_urn:
-      name: tei_urn
-      description: Transparency Exchange Identifier (URN)
+    # Identifiers
+    collection-identifier:
+      name: collection-identifier
+      description: TEA Collection Identifier
       in: path
       required: true
       schema:
-        type: string
-    tea_product_identifier:
-      name: tea_product_identifier
-      description: TEA Product Identifier
+        $ref: "#/components/schemas/type_uuid"
+    leaf-identifier:
+      name: leaf-identifier
+      description: TEA Leaf Identifier
       in: path
       required: true
       schema:
-        type: string
-    product_version:
-      name: product_version
-      description: Product Version string
+        $ref: "#/components/schemas/type_uuid"
+    product-identifier-type:
+      name: product-identifier-type
+      description: The identifier type (enum)
       in: path
       required: true
       schema:
-        type: string
-    tea_collection_identifier:
-      name: tea_collection_identifier
-      description: TEA Collection Identifier
-      in: path
+        $ref: "#/components/schemas/type_product_identifier_type"
+    product-identifier:
+      name: product-identifier
+      description: The actual identifier string
+      in: query
       required: true
       schema:
         type: string
-    tea_leaf_identifier:
-      name: tea_leaf_identifier
-      description: TEA Leaf Identifier
+    # @todo - REVIEW AS THIS IS USED AS A UUID in /product/uuid/{uuid} ??
+    tei_urn:
+      name: tei_urn
+      description: Transparency Exchange Identifier (URN)
       in: path
       required: true
       schema:
         type: string
-    purl:
-      name: purl
-      description: Package URL (PURL)
-      in: query
-      required: false
-      schema:
-        type: string
-    barcode:
-      name: barcode
-      description: Barcode
-      in: query
-      required: false
-      schema:
-        type: string
-    sku:
-      name: sku
-      description: Product SKU
-      in: query
-      required: false
-      schema:
-        type: string
-    vendor_uuid:
-      name: vendor_uuid
-      description: Vendor UUID
-      in: query
-      required: false
-      schema:
-        "$ref": "#/components/schemas/uuid"
   securitySchemes:
     bearerAuth:
       type: http
       scheme: bearer
     basicAuth:
       type: http
       scheme: basic
-  security_requirements:
-    standard_auth:
-      - bearerAuth: []
-      - basicAuth: []
-  operations:
-    standard_delete:
-      responses:
-        "$ref": "#/components/responses/standard_delete"
-      security:
-        "$ref": "#/components/security_requirements/standard_auth"
 security:
   - bearerAuth: []
   - basicAuth: []