documented extension endpoint

matweb/oas/download.yml

@@ -26,8 +26,6 @@ parameters:
 
 responses:
   200:
-    description: "An object containing all info about the cleaned file"
-    schema:
-      $ref: '#/definitions/UploadResponse'
+    description: ""
   404:
-    description: "The filename, key or secret are wrong"
+    description: "The filename, key or secret are wrong or the link is too old and the file has been deleted"

matweb/oas/extension.yml

@@ -0,0 +1,17 @@
+---
+tags:
+  - "Supported Extensions"
+summary: 'Returns a list of all supported file extensions'
+consumes:
+  - "application/json"
+produces:
+  - "application/json"
+
+responses:
+  200:
+    description: "A list of all supported file extensions"
+    schema:
+      type: "array"
+      items:
+        type: "string"
+        example: ".jpeg"

matweb/rest_api.py

@@ -160,5 +160,6 @@ class APIBulkDownloadCreator(Resource):
 
 
 class APISupportedExtensions(Resource):
+    @swag_from('./oas/extension.yml')
     def get(self):
         return utils.get_supported_extensions()