Added root object names for better api first code generation

existingApis.yaml

@@ -22,12 +22,7 @@ paths:
           content:
             application/json:
               schema:
-                type: array
+                $ref: '#/components/schemas/SimilarProducts' 
-                description: List of productIds similar to a given one ordered by similarity
-                minItems: 0
-                uniqueItems: true
-                items:
-                  type: integer
   '/product/{productId}':
     parameters:
       - schema:
@@ -45,6 +40,20 @@ paths:
           content:
             application/json:
               schema:
+                 $ref: '#/components/schemas/ProductDetail'
+        '404':
+          description: Product Not found
+components:
+  schemas:
+    SimilarProducts:
+      type: array
+      description: 'List of similar product Ids to a given one ordered by similarity'
+      minItems: 0
+      uniqueItems: true
+      items:
+        type: string
+        example: ["1","2","3"]
+    ProductDetail:
       description: 'Product detail'
       type: object
       properties:

readme.md

@@ -1,7 +1,7 @@
 # Backend dev technical test
-We want to offer a new feature to our customers showing similar products to the one they are seeing. To do this we agreed with our front-end applications to create a new REST API that will provide them the product detail of similar products to a given one. [Here](./similarProducts.yaml) is the contract we agreed.
+We want to offer a new feature to our customers showing similar products to the one they are currently seeing. To do this we agreed with our front-end applications to create a new REST API operation that will provide them the product detail of the similar products for a given one. [Here](./similarProducts.yaml) is the contract we agreed.
 
-We already have an endpoint that provides the product Ids similar to a given one. We also have another endpoint that returns the product detail by productId. [Here](./existingApis.yaml) is the documentation of the existing APIs.
+We already have an endpoint that provides the product Ids similar for a given one. We also have another endpoint that returns the product detail by product Id. [Here](./existingApis.yaml) is the documentation of the existing APIs.
 
 **Create a Spring boot application that exposes the agreed REST API on port 5000.**
 

similarProducts.yaml

@@ -21,17 +21,21 @@ paths:
           content:
             application/json:
               schema:
+                 $ref: '#/components/schemas/SimilarProducts'
+        '404':
+          description: Product Not found
+components:
+  schemas:
+    SimilarProducts:
       type: array
       description: 'List of similar products to a given one ordered by similarity'
       minItems: 0
       uniqueItems: true
       items:
+        $ref: '#/components/schemas/ProductDetail'
+    ProductDetail:
+      description: 'Product detail'
       type: object
-                  required:
-                    - id
-                    - name
-                    - price
-                    - availability
       properties:
         id:
           type: string
@@ -43,3 +47,8 @@ paths:
           type: number
         availability:
           type: boolean
+      required:
+        - id
+        - name
+        - price
+        - availability