Swagger UI无法正确发送数组

时间:2016-03-31 09:44:42

标签: swagger swagger-ui swagger-2.0

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

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

实际

recipients[]=value1%2Cvalue2

预期

recipients[]=value1&recipients[]=value2

%2C表示,(逗号)。

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

1 个答案:

答案 0 :(得分:3)

看起来指定此方法的方法是添加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。这是有效的 仅用于"查询"中的参数或" formData"。