Я провел последние несколько дней, пытаясь понять, следует ли мне использовать план API, RAML или чванство.
Похоже, у swagger самое большое сообщество, но чем ближе я смотрю, тем больше я чувствую, что ему сильно не хватает документации (мне приходилось много раз просматривать код, чтобы попытаться интегрировать его в мой текущий проект), много проблем с github и stackoverflow. вопросы без ответа.
Возможно ли, что я что-то упускаю здесь? Все, что мне нужно, — это инструмент, который поможет мне написать документацию по API и протестировать конечные точки.
Почему чванство должно стать частью серверной логики?? Если я создаю файлы swagger в редакторе, а затем передаю их UI прямо ломается..
Насколько я могу судить, это даже делает сервер немного медленнее и заставляет существовать множество неуклюже поддерживаемых интеграций: p Что я здесь упускаю?
