enable multiple file support?

[fehguy]

While not explicitly allowed, it seems we might want to enable type: file inside arrays to allow for support of multiple files.

[JamesMessinger]

Can't you already accomplish this by simply having more than one parameter with {type: "file"}? As long as your Content-Type is multipart/form-data, you can send multiple files in a single request.

Or am I missing something?

[webron]

@BigstickCarpet - the idea is to allow an undefined number of files to upload. You can set several individual parameters but that's not quite the same.

[JamesMessinger]

Ah, ok. 👍

[bytesandwich]

Any thoughts on this? multiple file upload (where the user decides how many files to upload) seems like a really common use case.
Enough that dropzone has nearly 8,000 stars https://github.com/enyo/dropzone

[webron]

So following #50, we may be able to allow the declaration of an array of "type": "string", "format": "binary" as a workaround for multiple file upload definitions.

[Hronom]

Any progress on this?

[fehguy]

Most likely part of 3.0

[akkie]

Currently this should be possible with:

- name: files
  in: formData
  description: Upload multiple files
  required: true
  type: array
  items:
    type: File
  collectionFormat: multi

If the documentation could be adapted to:

corresponds to multiple parameter instances instead of multiple values for a single instance foo=bar&foo=baz. This is valid only for parameters in "query" or "formData". For files in "formData" an numeric index will be appended to the parameter name (files0, files1, ...).