Разве чванские инструменты используют только формат json?

Question

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

Answer 1

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

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

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