指定數組作爲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[]語法應該有所斬斷。