на самом деле, проблема выглядит так
1. RESTful довольно сложно разрабатывать - постоянно хочется срезать угол, а результатом будет архитекрутра в говне
2. поэтому многие разработчики забивают на RESTful рекомендации сразу. результатом будет - сюрприз - архитекрутра в говне
3. единственный выход - это определить свой стандарт, который можно будет описать в терминах openapi с одной стороны, и который будет легко соблюдать при разработке с другой. что-то вроде “все запросы post, все ответы 200 и 400. в 400 возвращаем тело, в нем описание ошибки. параметры передаем так-то, ошибки возвращаем так-то”