src/openapi/products/products-crud-v2.2.yaml

@@ -1,13 +1,13 @@
 openapi: 3.0.1
 info:
-  title: ABTProducts (based on domainmodel v2.2)
+  title: ABTProducts
   description: >-
     CRUD APIs for HTM products (based on the new domainmodel v2.2). Internal use
     only; external touchpoints can get read-only, filtered access via the HTM
     Service Engine, using a different endpoint.
-  version: '2.2'
+  version: '1.0'
 servers:
-  - url: https://api.integratielaag.nl/abt/products/2.2
+  - url: https://api.integratielaag.nl/abt/products/21.0
 tags:
   - name: ABTProducts CRUD
     description: >-
@@ -27,6 +27,16 @@ paths:
         only products that have active sellingPeriods for touchpoints within the same 
         retailer as the calling retailer are returned. \
         Touchpoint 1 and 2 belong to retailer 1; touchpoint 3 and 4 belong to retailer 2.
+      parameters:
+        - name: parentProductId
+          in: query
+          required: false
+          description: |-
+           Only return products that refer to the given parentProductId. \
+           Returns parent-products (i.e. products with parentProductId = null) if left empty.
+          schema:
+            type: integer
+            example: 1
       responses:
         '200':
           description: OK