Как сгенерить интерактивную OpenAPI документацию?

Question

[Bob89991]

Есть .yaml файл с описанием API, как из него получить интерактивный html?
Нужно что-то вроде этого:


С сайта https://app.swaggerhub.com/ можно экспортнуть только страшного вида html-ы, а нужен вид именно как в примере.

Answer 1

[Станислав Макаров]

Такую штуку на разных технологических стеках часто можно выставить с помощью какого-нибудь middleware, например в связке с ASP.NET Core с задачей хорошо справляется Swashbuckle:

app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("v1/swagger.json", "My API V1");
});

Ну а если вам нужно оформить исключительно ваше yaml-описание - ну тогда задача сводится к приручению Swagger UI.