fix: Fix missing components in spec

Resolves #9 (closed)

spec/openapi.yaml

@@ -7,7 +7,7 @@ info:
     url: https://www.eclipse.org/legal/epl-2.0/
 
 servers:
-  - url: https://api.eclipse.org/download
+  - url: https://api.eclipse.org/downloads
     description: Production endpoint for the download information
 
 tags:
@@ -17,6 +17,22 @@ tags:
     description: Definitions in relation to retrieval of mailing lists
 
 paths:
+  /file:
+    get:
+      tags:
+        - Files
+      summary: List of files
+      description: Returns a list of all file index metadata
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Files"
+        500:
+          description: Error while retrieving data
+
   /file/{file_id}:
     parameters:
       - name: file_id
@@ -72,7 +88,7 @@ paths:
               schema:
                 $ref: "#/components/schemas/Release"
         400:
-          description: Bad Request
+          description: Bad Request - Invalid release type
           content:
             application/json:
               schema:
@@ -80,6 +96,22 @@ paths:
         500:
           description: Error while retrieving data
 
+  /releases/active:
+    get:
+      tags:
+        - Releases
+      summary: Active releases
+      description: Returns a list of active releases
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Releases"
+        500:
+          description: Error while retrieving data
+
   /releases/{releaseType}/{releaseName}:
     parameters:
       - name: releaseType
@@ -107,7 +139,13 @@ paths:
               schema:
                 $ref: "#/components/schemas/Releases"
         400:
-          description: Bad Request
+          description: Bad Request - Invalid release type
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+        404:
+          description: Not Found - Release name not found
           content:
             application/json:
               schema:
@@ -120,7 +158,7 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/Error"
-          
+
   /releases/{releaseType}/{releaseName}/{releaseVersion}:
     parameters:
       - name: releaseType
@@ -154,7 +192,13 @@ paths:
               schema:
                 $ref: "#/components/schemas/Release"
         400:
-          description: Bad Request
+          description: Bad Request - Invalid release type
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+        404:
+          description: Not Found - Release name/version not found
           content:
             application/json:
               schema:
@@ -167,7 +211,7 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/Error"
-                
+
 components:
   schemas:
     NullableString:
@@ -332,18 +376,18 @@ components:
             sha512:
               $ref: "#/components/schemas/NullableString"
               description: the sha512 checksum for the release file
-    
+
     Error:
       type: object
       properties:
-        status_code: 
+        status_code:
           type: integer
           description: HTTP response code
         message:
           type: string
           description: Message containing error information
         url:
-          type: 
+          type:
             - string
             - "null"
-          description: The URL          
+          description: The URL