В Swagger 2.0, что на самом деле должно означать «по умолчанию» в параметре массива? - PullRequest
0 голосов
/ 25 июня 2018

В хорошо известном чтиве petstore конечная точка findByStatus принимает статус:

"parameters": [
    {
        "name": "status",
        "in": "query",
        "description": "Status values that need to be considered for filter",
        "required": true,
        "type": "array",
        "items": {
            "type": "string",
            "enum": [
                "available",
                "pending",
                "sold"
            ],
            "default": "available"
        },
        "collectionFormat": "multi"
    }
]

Хотя из этого следует исходить из значения по умолчанию, с программной точки зрения то, что следует ожидать как значение для "status "(и для других параметров в аналогичном случае)?

  • Значением является тип array, для него нет значения по умолчанию
  • Каждый элемент является строкой, один из доступных, в ожидании или продаже, и по умолчанию, если не указано, «доступно»

Как бы вы использовали «по умолчанию» для массива произвольной длины?По умолчанию предоставляется строка, а не массив, поэтому:

  • Означает ли это, что массив не имеет значения по умолчанию?
  • Означает ли это, что массив имеет значение по умолчанию, равноемассив с одним элементом, который является значением по умолчанию для элементов массива?
  • Означает ли это массив произвольной длины, где все значения являются значениями по умолчанию для элементов массива?
...