G
В смысле - в index.html (условно) добавить ссылки на yaml страницы?
Size: a a a
2021 January 08
Z
Переделать main page у свагера.
И я говорил именно об этом что вам нужно настроит генератор чтобы он разбил на несколько файлов yaml или группы.
Z
German
В смысле - в index.html (условно) добавить ссылки на yaml страницы?
Ну а как вы думаете по другому? Есть стандартнный вариант и вы можете его пилить под любой лад. Только вот как это сделать вам лучше читать документацию.
G
Ну а как вы думаете по другому? Есть стандартнный вариант и вы можете его пилить под любой лад. Только вот как это сделать вам лучше читать документацию.
Думал, внутри Yaml-файлов есть возможность делать неограниченное количество гиперссылок на другие yaml-ы (не ref-ы)
Z
German
Думал, внутри Yaml-файлов есть возможность делать неограниченное количество гиперссылок на другие yaml-ы (не ref-ы)
Мне кажется у вас немножко искаженное представление об openapi.
Z
Мне кажется у вас немножко искаженное представление об openapi.
Или может у меня поскольку я давно работаю только первой версией.
G
Или может у меня поскольку я давно работаю только первой версией.
скорее у меня.
Спасибо за ответ
Спасибо за ответ
Z
German
Yaml будем дописывать.
Мне сейчас главное, чтобы:
- При изменении API не забывали изменять его описание.
- При добавлении API не забывали делать его описание.
Мне сейчас главное, чтобы:
- При изменении API не забывали изменять его описание.
- При добавлении API не забывали делать его описание.
Ну посмотрите генератор работает примерно так. С помощью рефлексии (это в дотнете думаю и в java тоже самое) получает все доступные сервисы и методы получает сущности и на их основе генерирует yaml файл. Вот вся магия. А дальше этот файл в красивом виде отображается с помощью хтмл и жс.
G
Я правильно понимаю, что?
При этом, автоматически сгенерированный файл yaml, не является достаточно юзер-френдли при отображении в сваггере. К примеру:
- Не указываются возможные значения и ограничения ("type: string" вместо "type: string, 14 digits")
- Не указываются примеры использования.
То есть, его ещё желательно ручками дорабатывать
При этом, автоматически сгенерированный файл yaml, не является достаточно юзер-френдли при отображении в сваггере. К примеру:
- Не указываются возможные значения и ограничения ("type: string" вместо "type: string, 14 digits")
- Не указываются примеры использования.
То есть, его ещё желательно ручками дорабатывать
Z
Ну посмотрите генератор работает примерно так. С помощью рефлексии (это в дотнете думаю и в java тоже самое) получает все доступные сервисы и методы получает сущности и на их основе генерирует yaml файл. Вот вся магия. А дальше этот файл в красивом виде отображается с помощью хтмл и жс.
Так вот зная этот "секрет" можете сгенерировать хоть книжку в формате пдф или в любом в другом виде сайт.
Z
German
Я правильно понимаю, что?
При этом, автоматически сгенерированный файл yaml, не является достаточно юзер-френдли при отображении в сваггере. К примеру:
- Не указываются возможные значения и ограничения ("type: string" вместо "type: string, 14 digits")
- Не указываются примеры использования.
То есть, его ещё желательно ручками дорабатывать
При этом, автоматически сгенерированный файл yaml, не является достаточно юзер-френдли при отображении в сваггере. К примеру:
- Не указываются возможные значения и ограничения ("type: string" вместо "type: string, 14 digits")
- Не указываются примеры использования.
То есть, его ещё желательно ручками дорабатывать
Типы данных точно там будет. А вот с примерами это зависит от возможности генератора. К примеру описание методо и параметром он получает из комментариев. А вот примеры ручками. Либо допилить генератор. Это проще.
Z
German
Я правильно понимаю, что?
При этом, автоматически сгенерированный файл yaml, не является достаточно юзер-френдли при отображении в сваггере. К примеру:
- Не указываются возможные значения и ограничения ("type: string" вместо "type: string, 14 digits")
- Не указываются примеры использования.
То есть, его ещё желательно ручками дорабатывать
При этом, автоматически сгенерированный файл yaml, не является достаточно юзер-френдли при отображении в сваггере. К примеру:
- Не указываются возможные значения и ограничения ("type: string" вместо "type: string, 14 digits")
- Не указываются примеры использования.
То есть, его ещё желательно ручками дорабатывать
Ага точно не юзер фрэндли. А сваггер это как бы гуи. Стандартный. Если нужно другое пилите.
Z
Вы не первый в этом и поищите в Гугле. В мире полно готовых решений.
G
Спасибо
D
Мужики, у кого есть старая неработающая клавиатура с кабелем ps/2?
G
Мужики, у кого есть старая неработающая клавиатура с кабелем ps/2?
Возможно дома валяется рабочая. Не жалко. Сегодня вечером посмотрю
D
German
Возможно дома валяется рабочая. Не жалко. Сегодня вечером посмотрю
спасибо
R
Потому что 99.99% народа с подобными вопросами не читают документацию
нет.... Потому что все эти люди сами не компетентны в данном вопросе)
J
Открыты вакансии в фирме Airnauts
Нам нужны:
#Angular Developer
#React/Frontend Developer
#Backend Developer
#WP/PHP Developer
#Android Developer
#iOS Developer
-опыт : не менее 1 года
- знание английского (мин в2)
- полная занятость
-100% удалённо
Длительное сотрудничество.
Интернациональный коллектив.
Ставка - 2200-5000$ /месяц
Ждем ваши резюме :
E-mail: anna@airnauts.com
Telegram : @kryzhanivska_anya
👉 Подписаться на канал @UzDev_Jobs
Нам нужны:
#Angular Developer
#React/Frontend Developer
#Backend Developer
#WP/PHP Developer
#Android Developer
#iOS Developer
-опыт : не менее 1 года
- знание английского (мин в2)
- полная занятость
-100% удалённо
Длительное сотрудничество.
Интернациональный коллектив.
Ставка - 2200-5000$ /месяц
Ждем ваши резюме :
E-mail: anna@airnauts.com
Telegram : @kryzhanivska_anya
👉 Подписаться на канал @UzDev_Jobs
S
Jamol, пожалуйста, нажмите на кнопку ниже в течение указанного времени, иначе вы будете кикнуты. Спасибо! (240 сек)
При поддержке Золота Бородача
При поддержке Золота Бородача