OpenAPI(swagger): Генерация рускоязычного описание API

Заказчик у нас - московское метро, из этого возникают странные задачи типа необходимости иметь фиксированное, а не живое описание API, причем на русском языке.

Уже первая задача непростая, ведь гораздо удобнее для изучения Open API использовать swagger ui, который, например, входит в генерируемые с помощью swagger codegen сервера.

Но заказчику надо что-то, что он может положить в шкаф. То, что выходит из swagger codegen таковым не является.

Ок, нашелся bootprint-openapi.

Вторая проблема, с русификацией, решалась несложно - я форкнул проект и буквально за полчаса получил устраивающую нас русификацию (она не совсем точна с точки зрения OpenAPI, но она отражает именно то, что мы хотели показать заказчику).

Правда, как обычно, двумя проблемами никогда не заканчивается, потом возникла третья, но это уже другая история.

Опубликовано July 15, 2016