aiohttp-swagger icon indicating copy to clipboard operation
aiohttp-swagger copied to clipboard

Multipart form body is not rendered properly

Open mykola-mokhnach opened this issue 5 years ago • 1 comments

Hello,

I am trying to describe the parameters for an API endpoint, which is supposed to serve file uploads. My docstring looks like

    async def handle_upload(self, request: web.Request) -> web.Response:
        """
        ---
        description: This end-point allows to upload files to the storage service.
        tags:
        - Upload
        produces:
        - application/json
        parameters: []
        requestBody:
          required: true
          content:
            multipart/form-data:
              schema:
                type: object
                required:
                  - payload
                properties:
                  payload:
                    type: string
                    format: binary
                    description: the content of the file to be uploaded
                  name:
                    type: string
                    description: the file name (if unset then will be retrieved from `content-disposition` header)
        responses:
          "201":
            description: successful operation

...

Although the generated Swagger document looks like

upload

and does not contain any controls, which would allow file upload.

My question is whether such format supported by the library? Should I, probably, use another approach to describe multipart/form-data content?

mykola-mokhnach avatar Nov 07 '19 13:11 mykola-mokhnach

Just checking if there is any update on supporting "Multipart forms" in the library?

meitham avatar Feb 17 '22 13:02 meitham