апи? плюсы минусы
swager
что-то глянул не понравился он мне, тоже вопрос как бороться с добавлением новых методов изменения существующих, какое-то разделение по версионности в доке
Сделал - сгенерировал, вышла новая версия АПИ - кодируй в другое место.
вы не поняли видимо. для фронтенщика например удобно смотреть что поменялось
swager для фронта чем не подходит?
точно не поняли)) changelog нужен в доке, чтобы отображались изменения, swagger уже давно динозавр и как по мне не удобное дерево документации, когда ты листаешь этот список
1) Написал код, 2) сделал к нему сваггер комменты. 3) Запустил в консоли комануд пересборки сваггер документации 4) Зашел по ссылке и увидел все методы с параметрами, возможностью отправить запросы из html
что именно?
точно не поняли) это вы описали ваш рабочий процесс каждый день) а что вчера было и изменилось по сравнению с сегодняшним днем вы как-то фронтенщику сообщите? или просто поменяете доку на метод
ну и чендж лог - такая себе затея. ендпоинт менятся не должен! если он меняется то надо создавать отдельный ендпоинт. желатенльно с версией в path, по семвер
ну в момент разработки он всегда меняется, это не значит что надо создавать 300 эндпоинтов ))
Мне кажется, что если у вас меняется дока на метод - это уже проблема архитектуры приложения
ченджлог для разработки как бы тоже не надо))
ахаха понял, учту 😂
с чего так решили? ) есть кстати хороший сервис который дает крутой инструмент, но он дорогой, там как раз уделили внимание этому моменту
Есть бизнесзадача эндопоинта. Есть входные параметры и есть что должно быть на выходе - и это по сути должно быть констаной всегда и не меняться. Если появляются или удаляются эти правла, жди где-то краша. Особенно если твое АПИ юзает даже 1000 человек, явно они все у себя менять методы не ожидают
у них пока не настолько все серьезно вроде
Если на стадии разработки, то чем конечный список АПИ не подходит?
я вас уже услышал выше ) но за мнение спасибо я бы не стал следовать вашим подходом, спорить тоже не буду)
Обсуждают сегодня