Я считаю, что совершенно нормально, что изменения потребуют времени. В моей предыдущей компании я руководил отделом разработчиков, и, боже мой… нам потребовалось более двух лет, чтобы довести наши API до улучшенного состояния. Столько сложных моментов нужно было учесть (и инженеры ненавидели саму идею создания стабильной конечной точки, которую нельзя было бы изменять!).
Однако я считаю, что более мелкие изменения могут происходить постепенно и в более короткие сроки. Признаюсь, я не изучал, как определяются ваши маршруты (или как маршруты определяются в Ruby), но предполагаю, что некоторые очевидные улучшения можно реализовать довольно легко. Например:
Я не могу говорить от имени всех, но мне кажется, что даже простое наличие конечных точек в вашей текущей спецификации API — даже без описаний и примеров, и даже если модель ответа будет изменчивой — стало бы огромным успехом. Иногда сам факт того, что что-то существует, — это уже половина дела.