Мне нравится чарты для документирования Restful API, особенно "Try it out!"., но интерфейс swagger-ui выглядит не очень круто.
И я не могу поверить, что нет никаких шаблонов для такого потрясающего инструмента с открытым исходным кодом (или я не могу найти его)?
Я не хочу этого бесплатно.. Как http://getbootstrap.com/ есть много сайтов для покупки тем (например https://wrapbootstrap.com/), почему я не могу найти какой-либо сайт для разворачиваемых тем?
Поздний ответ, хотя и хороший. Это очень здорово! Сглаженная реализация, и он настроил много вещей, которые легко настроить еще раз для ваших нужд: https://github.com/jensoleg/swagger-ui.
Кредиты идут в эту группу google: https://groups.google.com/forum/#!topic/swagger-swaggersocket/oeMyayrvKRI. Странно, что это еще не было опубликовано.
Для демонстрации действий ознакомьтесь с этой ссылкой: http://senodio.com/site/swagger/#!/pet/addPet
-
EDIT: Недавно было обнаружено, что DEMO не работает, поэтому я разблокировал Repo (https://github.com/MartinSahlen/swagger-ui) и создал простой node/express сервер, который работает на Heroku. Имейте в виду, что это бесплатный геройку dyno, так что потребуется некоторое время для загрузки (~ 20 секунд), если в течение некоторого времени на нем мало активности.
Добро пожаловать: http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet
ИЗМЕНИТЬ 2: Просто наткнулся на другой, который выглядит многообещающим: https://github.com/legendecas/material-swagger-ui , Также кажется, что swagger ui, на котором я сейчас размещаюсь, воскрешен на http://swaggerui.herokuapp.com/. Сохраняя мой, а также в случае его снятия снова.
Это коллекция тем стилей, которые могут быть применены к интерфейсу Swagger. Ссылка ниже на мое репо о том, как использовать.
Надеюсь, что это поможет.
Swagger-UI, не будучи новым инструментом, очень специфичен для своей задачи. Я не знаю ни одного веб-сайта, который предоставляет темы для него (бесплатно или оплачивается). Многие из его пользователей настроили пользовательский интерфейс, чтобы соответствовать их местной теме. Некоторые из них сделали тонкие изменения, некоторые из них прошли капитальный ремонт.
Я бы рекомендовал оглянуться на доступные реализации и посмотреть, подходит ли что-то для ваших нужд. Затем, возможно, попросите разрешения повторно использовать свою тему/шаблон для ваших собственных нужд.
Еще один вариант - ReDoc.
Вам просто нужно принести файл swagger.json с index.html. Простая настройка.
<head>
<title>ReDoc</title>
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1">
<link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
<style>
body {
margin: 0;
padding: 0;
}
</style>
</head>
<body>
<redoc spec-url='your.swagger.json'></redoc>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/bundles/redoc.standalone.js"> </script>
</body>
Я недавно разветкил рефакторинг темы swagger-ui, о которой говорилось выше, используя bootstrap v4 для всех, кому это интересно. Смотрите его здесь https://github.com/afgarcia86/bootstrap-swagger-ui
Вы можете использовать Swagger-Boostrap-UI
github: https://github.com/xiaoymin/Swagger-Bootstrap-UI
поддержка экспорта уценки apis и так далее...
Оформить заказ RapiDoc