dude dude
1) Посмотри примеры Rest-сеовисов на swagger.
2) Возможно не соблюден контракт на методы get/post/put (получение данных/добавление/изменение)
3) ошибки сервиса видимо должны быть с кодом, отличным от "200"
К сожалению нормальной литературы посоветовать не могу. Посмотри API реально существующих сервисов ( zoom, вконтач, wechat , и ТП). Гулгится так: zoom rest api.
По поводу контракта на методы возможно , я через гет запрос получал параметры хттп и возвращал ResponseEntity с фигурой
400 код на ошибках
Про сваггер спасибо