swagger-ui

swagger ui Несколько схем API (микросервисы)

Что почитать:

  1. Multiple REST API microservices endpoints in a single Swagger UI: https://dejanstojanovic.net/aspnet/2020/...

swagger Как сгнерировать HTML страницу c документацией (напр. из yaml)

Предположим, что yaml с информацией о метода вы генерировать уже уже научились и теперь нам надо перегнуть его в html.

Наиболее простым способом является (но не самым быстрым и удобным):

  1. взять сгенерированный yaml
  2. добавить его слева в область кода на https://editor.swagger.io/
  3. и далее из главного меню:
    Generate Client -> html2

    качаем получившийся html и наслаждаемся)

Subscribe to RSS - swagger-ui