Инструменты генераторов OpenAPI и CLI для заглушек серверов - PullRequest
0 голосов
/ 26 сентября 2018

Я знаком с RESTful API, однако я новичок в Swagger и Open API.Я хотел бы уточнить роль таких инструментов, как openapi-generator-cli и как наилучшим образом использовать эти инструменты.

Используя новейшую спецификацию для OpenAPI , понятно, какразработать API.Например, я могу написать свой API в файл .yml.В моем случае я использую Java и SpringBoot в качестве языка и мне интересно использовать open-generator-cli для создания заглушки сервера из файла .yml.

Затем я могу указать своему браузеру http://localhost:8080/swagger-ui.html#/. Кроме предоставления хорошей документации, в которой указаны конечные точки, параметры, модель, ответы и запрос скручивания, какое еще значение предоставляет серверная заглушка?Принято ли брать код сервера и адаптировать его к производственной базе кода?И затем, когда API-интерфейс изменится, все шаги будут повторяться легче?

...