Ну вот мы используем сваггер со springfox, очень удобно.
С аннотациями конечно и с добавлением всяких параметров немножко гемор, зато аналитики сами могут их тестировать, прямо на сервере.
Прикрутили туда авторизацию, чтобы запросы с токеном уходили, файлы можно загружать из интерфейса в пост-запросы, джейсончики всякие там, параметры запроса из менюшек выбирать.
Единственное, пока не совсем понятно как правильно прописать пример(template) json'ов, сейчас стандартный объект со всеми полями в области для ввода по-умолчанию перед выполнением отображается, но особо не напрягает.