指定数组作为GET参数使用扬鞭/ OpenAPI的规格

Question

以下招摇定义被发送：

swagger: '2.0' 
host: example.com 
paths: 
    /theResource: 
    get: 
     parameters: 
     - $ref: '#/parameters/fields' 
parameters: 
    fields: 
    name: fields 
    description: Fields to return 
    in: query 
    type: array 
    collectionFormat: multi 
    uniqueItems: true 
    items: 
     type: string 
     enum: 
     - column1 
     - column2 
     - column3 

将生成以下URL，并且服务器将仅接收fields等于column3。

http://example.com/theResource?fields=column1&fields=column2&fields=column3 

如何更改它，以便它在参数中发送数组？例如：

http://example.com/theResource?fields[]=column1&fields[]=column2&fields[]=column3 

Answer 1

在PHP中，您可以使用http_build_query，它会为您构建正确的URL查询部分。

<?php 

$query = http_build_query([ 
    'fields' => [ 
     'one', 'two', 'three' 
    ], 
]); 

$url = "https://example.com/?".$query; 

是的，fields[]语法应该有所斩断。