runnable swagger

public/swagger/swagger-files.yaml

@@ -0,0 +1,50 @@
+paths:
+  get:
+    tags:
+    - files
+    summary: "Fetch a file"
+    parameters:
+    - $ref: "#/components/parameters/path"
+    responses:
+      200:
+        content:
+          text/plain:
+            schema:
+              type: string
+
+  post:
+    tags:
+    - files
+    summary: "Provide or direct link to a file"
+    parameters:
+    - $ref: "#/components/parameters/path"
+    - $ref: "#/components/parameters/direct"
+    requestBody:
+      description: "If ?direct=true, then a direct link to the file, else a multi-part form"
+      content:
+        text/plain:
+          schema:
+            type: string
+            example: "http://imgur.com/img/mine.png"
+        application/x-www-form-urlencoded:
+          schema:
+            type: string
+            example: "password=123"
+    responses:
+      200:
+        $ref: "#/components/schemas/ok"
+
+components:
+  parameters:
+    path:
+      $ref: "./swagger.yaml#/components/parameters/path"
+
+    direct:
+      name: direct
+      in: query
+      schema:
+        type: bool
+
+  schemas:
+    ok:
+      $ref: "./swagger.yaml#/components/schemas/ok"