Ich halte es für absolut vernünftig, dass die Umstellung Zeit braucht. Ich leitete die Entwicklerbeziehungen in meinem letzten Unternehmen und meine Güte… es dauerte über zwei Jahre, bis unsere APIs in einem verbesserten Zustand waren. So viele komplexe Dinge zu berücksichtigen (und das Engineering hasste die Idee, einen stabilen Endpunkt zu schaffen, der sich nicht ändern konnte!)
Ich glaube jedoch, dass kleinere Änderungen im Laufe der Zeit und in kürzeren Zeiträumen ebenfalls möglich sind. Ich habe mir zugegebenermaßen nicht angesehen, wie Ihre Routen (oder wie Routen in Ruby) definiert sind – aber ich gehe davon aus, dass einige leicht zu handhabende Dinge ziemlich einfach erledigt werden könnten. Zum Beispiel:
Ich kann nicht für alle sprechen, aber ich habe das Gefühl, dass es schon ein großer Gewinn wäre, wenn die Endpunkte in Ihrer aktuellen API-Spezifikation vorhanden wären – auch wenn Sie keine Beschreibungen und Beispiele hätten und auch wenn das Antwortmodell fließend wäre. Allein das Wissen, dass etwas existiert, ist manchmal die halbe Miete.