Я использую Swagger-php. Когда я определяю параметр в строке запроса, он может быть массивом. Но насколько я вижу, он не поддерживает такую строку запроса:
https://api.domain.tld/v1/objects?q[]=1&q[]=5&q[]=12
Я думаю, что это будет установлено в поле CollectionFormat, если это возможно. В настоящее время я просто использую каналы, но я хочу использовать вышеуказанный формат, и Swagger-UI тоже это отражает. Однако я прочитал эту проблему на GitHub, которая заставила меня задуматься, возможно ли это на самом деле, и я просто пропустил это?
Пример моего определения Swagger-PHP:< /p>
/**
* @SWG\Parameter(
* name="ids",
* in="query",
* description="A list of IDs (separated by pipes) to filter the Returns",
* required=false,
* type="array",
* @SWG\Items(
* type="integer",
* format="int32"
* ),
* collectionFormat="pipes"
* )
*/
В результате получается следующий JSON:
"parameters": {
"ids": {
"name": "ids",
"in": "query",
"description": "A list of IDs (separated by pipes) to filter the Returns",
"required": false,
"type": "array",
"items": {
"type": "integer",
"format": "int32"
},
"collectionFormat": "pipes"
}
}
Подробнее здесь: https://stackoverflow.com/questions/378 ... ery-string
