Penso che sia del tutto ragionevole che il cambiamento richieda tempo. Ho gestito le relazioni con gli sviluppatori nella mia ultima azienda e, perbacco… ci sono voluti più di due anni per migliorare le nostre API. C’erano così tante cose complesse da considerare (e l’ingegneria odiava l’idea di creare un endpoint stabile che non potesse cambiare!)
Penso comunque che cambiamenti più piccoli possano avvenire nel tempo e in un lasso di tempo più breve. Ammetto di non aver esaminato come sono definite le tue route (o come sono definite le route in Ruby), ma presumo che alcuni “low-hanging fruit” (frutti facili da cogliere) potrebbero essere gestiti abbastanza facilmente. Ad esempio:
Non posso parlare per tutti, ma penso che anche solo avere gli endpoint presenti nella tua attuale specifica API, anche se non avessi descrizioni ed esempi, e anche se il modello di risposta fosse fluido, sarebbe un’enorme vittoria. A volte, sapere semplicemente che qualcosa esiste è metà della battaglia.