2015-01-19 1 views
46

Мне нравится чванство для документирования Restful APIs очень много, особенно «Попробуйте!» , но интерфейс swagger-ui выглядит не очень круто.Почему нет темы для swagger-ui?

И я не могу поверить, что нет никаких шаблонов для такого удивительного инструмента с открытым исходным кодом (или я не могу найти его)?

Я не хочу, чтобы это бесплатно .. Нравится http://getbootstrap.com/ есть много сайтов для покупок темы (например, https://wrapbootstrap.com/), почему я не могу найти какой-либо сайт для чатов?

+0

Если вы хотите, чтобы Swagger перешел на следующий уровень, зайдите на https://www.dynamicapis.com. Они берут ваши документы Swagger и создают потрясающий пользовательский интерфейс. Вот пример портала API, размещенного ими: https://www.dynamicapis.com/dapi/apis/0b971e55-c61f-4428-a65f-ca905bd52762 –

ответ

57

Поздний ответ, хотя и хороший. Это очень здорово! Отличная реализация, и он настроил много вещей, которые легко настроить еще раз для ваших нужд: 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) и создал простой узел/экспресс-сервер, который работает на геройку. Обратите внимание, что это бесплатный геройку, поэтому нагрузка (~ 20 секунд) может занять некоторое время, если в течение некоторого времени на нем будет мало активности.

Добро пожаловать: http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet

EDIT 2: Просто наткнулся на другой, который выглядит многообещающим: https://github.com/legendecas/material-swagger-ui . Также кажется, что swagger ui, на котором я сейчас размещаюсь, воскрешается на http://swaggerui.herokuapp.com/. Сохраняйте мою, а также в случае ее повторного спуска.

+0

ничего себе. хороший. Спасибо! –

+1

Просто хедз-ап: похоже, что ваша демонстрация действия зашла в прошлое. –

+0

Да, я знаю. Попробует добавить простое приложение heroku для его размещения, если оно не займет слишком много времени. –

4

Swagger-UI, не будучи новым инструментом, очень специфичен для своей задачи. Я не знаю ни одного веб-сайта, который предоставляет темы для него (бесплатно или оплачивается). Многие из его пользователей настроили пользовательский интерфейс, чтобы соответствовать их местной теме. Некоторые из них сделали тонкие изменения, некоторые - капитальный ремонт.

Я бы рекомендовал осматривать доступные варианты и посмотреть, подходит ли что-то для ваших нужд. Тогда, возможно, попросите разрешения повторно использовать свою тему/шаблон для ваших собственных нужд.

+0

Хорошо, спасибо, но я думаю, что эти реализации невозможно найти. , –

+1

Вы можете найти (очень) частичный список здесь - https://github.com/swagger-api/swagger-spec/wiki/Sites-and-Services. – Ron

+0

Еще раз спасибо! –

12

Это коллекция тем стилей, которые могут быть применены к пользовательскому интерфейсу Swagger. Ссылка ниже на мое репо о том, как использовать.

Надеюсь, это поможет.

https://github.com/ostranme/swagger-ui-themes

 Смежные вопросы

  • Нет связанных вопросов^_^