SwaggerUI 3不尊重OpenAPI 3规范中查询数组参数的' explosion: false '

Question

我有一个在OpenAPI 3规范中定义的查询参数如下:

parameters:
- in: query
name: categories
schema:
type: array
items:
type: string
enum:
- category1
- category2
style: form
explode: false

期望是，如果我使用"Try it out!"特征并同时选择category1和category2，则形成的URL应包含:?categories=category1,category2

然而，取而代之的是，SwaggerUI将URL的这一部分形成如下:?categories=category1&categories=category2

因此，似乎SwaggerUI正在处理该参数，好像explode被设置为true。

我怎么能让SwaggerUI去与逗号分隔的公式，因为这是什么服务器所期望的?

Answer 1

问题是explode和style属性应该被放置在与schema相同的级别，而不是嵌套在里面。

parameters:
- in: query
name: categories
style: form
explode: false
schema:
type: array
items:
type: string
enum:
- category1
- category2