Добро пожаловать в форум, Guest  >>   Войти | Регистрация | Поиск | Правила | В избранное | Подписаться
Все форумы / Java Новый топик    Ответить
 А кто нибудь работал со Swager aka Open API ?  [new]
Leonid Kudryavtsev
Member

Откуда:
Сообщений: 7994
https://ru.wikipedia.org/wiki/OpenAPI_(спецификация)

В чем профит при разработке?

Стандарт описания и документирования - это я понимаю. А для использования какая нибудь разница / выгода по сравнению с "просто" API есть?
8 ноя 19, 15:29    [22012410]     Ответить | Цитировать Сообщить модератору
 Re: А кто нибудь работал со Swager aka Open API ?  [new]
kolchanov
Member

Откуда: Питер
Сообщений: 180
Leonid Kudryavtsev,

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

Swagger умеет генерировать runtime описание на основании "обычного" rest api
8 ноя 19, 17:31    [22012513]     Ответить | Цитировать Сообщить модератору
 Re: А кто нибудь работал со Swager aka Open API ?  [new]
SpringMan
Member

Откуда:
Сообщений: 13
Удобная вещь для генерации гуи с описанием методов, с примерами вызова и возможностью самого вызова
8 ноя 19, 17:56    [22012534]     Ответить | Цитировать Сообщить модератору
 Re: А кто нибудь работал со Swager aka Open API ?  [new]
Leonid Kudryavtsev
Member

Откуда:
Сообщений: 7994
Спасибо.
Кодогенератор нашел (сначала не увидел), попытаюсь запустить.
8 ноя 19, 18:00    [22012538]     Ответить | Цитировать Сообщить модератору
 Re: А кто нибудь работал со Swager aka Open API ?  [new]
mayton
Member

Откуда: loopback
Сообщений: 42861
Эпизодически использовали его вебовскую часть. Не знаю существует ли другая.

По моему ... Swagger - это попытка внести некий стандарт в описание Rest-сервисов.

Сваггеровскими конфигами иногда швыряются между собой овнеры чтобы не париться текстовым
описанием и не передавать сорцы серверной части.
8 ноя 19, 18:08    [22012542]     Ответить | Цитировать Сообщить модератору
 Re: А кто нибудь работал со Swager aka Open API ?  [new]
lleming
Member

Откуда:
Сообщений: 1653
если прикрутить springfox то можно потренькать прям из браузера это API, без колдовства с питоном requests или curl-ом.
Сразу curl command отдается для примера в UI, если есть сомнения и хочется дернуть API из консоли прям на сервере.
Все видно.
Можно сгенерить прям доку (плагин к gradle)
Можно доку прям публиковать в конфлуенсе (плагин к grade).
8 ноя 19, 19:05    [22012574]     Ответить | Цитировать Сообщить модератору
 Re: А кто нибудь работал со Swager aka Open API ?  [new]
lleming
Member

Откуда:
Сообщений: 1653
можно еще в springfox api протегировать по версиями, фичам и т.д.
проще искать если API объемый
8 ноя 19, 19:09    [22012576]     Ответить | Цитировать Сообщить модератору
 Re: А кто нибудь работал со Swager aka Open API ?  [new]
Nixic
Member

Откуда: Perm
Сообщений: 1914
Ну вот мы используем сваггер со springfox, очень удобно.
С аннотациями конечно и с добавлением всяких параметров немножко гемор, зато аналитики сами могут их тестировать, прямо на сервере.
Прикрутили туда авторизацию, чтобы запросы с токеном уходили, файлы можно загружать из интерфейса в пост-запросы, джейсончики всякие там, параметры запроса из менюшек выбирать.
Единственное, пока не совсем понятно как правильно прописать пример(template) json'ов, сейчас стандартный объект со всеми полями в области для ввода по-умолчанию перед выполнением отображается, но особо не напрягает.
9 ноя 19, 09:15    [22012673]     Ответить | Цитировать Сообщить модератору
Все форумы / Java Ответить