Swagger UI 未正确发送数组

Question

我正在尝试发送多个值（一个数组）（请参阅规范中的第 93 行 ->... name: recipients[] ...）

我面临的问题是 Swagger-ui 调用端点如下：

实际

recipients[]=value1%2Cvalue2

预期

recipients[]=value1&recipients[]=value2

%2C 表示 ,（逗号）。

以下是所需的详细信息 swagger-ui 版本 2.1.1 以下是重现问题的 swagger 规范文件内容的链接： http://pastebin.com/V3ZuCjVz

Answer 1

看起来指定这个的方法是添加collectionFormat: multi

- name: recipients[]
  in: formData
  description: Email addresses for recipients (multiple values allowed).
  required: true
  type: array
  collectionFormat: multi
  items:
      type: string

http://swagger.io/specification/ 的可能值是：

• csv - 逗号分隔值 foo,bar。
• ssv - 空格分隔值 foo bar。
• tsv - 制表符分隔值 foo\tbar。
• 管道 - 管道分隔值 foo|bar。
• multi - 对应于多个参数实例，而不是 单个实例 foo=bar&foo=baz 的多个值。这是有效的 仅适用于“query”或“formData”中的参数。