В чванских инструментах используется только формат json

Question

Я использую Swagger для моей документации API API nodejs. Но как новичок я не знаю о чванливости пользовательского интерфейса. Я гуглю его и нахожу решение для того, что является инструментом swagger, но в документации по инструменту swagger они используют формат json, но мой вопрос: нельзя ли использовать формат swagger.yaml (YAML) для того же самого.

Answer 1

Согласно Спецификации OpenAPI (выделено мое):

Документ OpenAPI, соответствующий спецификации OpenAPI, сам по себе является объектом JSON, который может быть представлен в формате JSON или YAML.

Пользовательский интерфейс Swagger может обрабатывать определения JSON и YAML. Другие инструменты, связанные с OpenAPI, тоже должны - при условии, что они используют парсер YAML. Технически, YAML - это расширенный набор JSON, поэтому инструменты, использующие парсеры YAML (а не парсеры JSON), могут анализировать как YAML, так и JSON.