Nachdem ich viel Material zur REST-Versionierung gelesen habe, denke ich daran, die Aufrufe anstelle der API zu versionieren. Zum Beispiel:

http://api.mydomain.com/callfoo/v2.0/param1/param2/param3
http://api.mydomain.com/verifyfoo/v1.0/param1/param2

anstatt zuerst zu haben

http://api.mydomain.com/v1.0/callfoo/param1/param2
http://api.mydomain.com/v1.0/verifyfoo/param1/param2

dann gehe zu

http://api.mydomain.com/v2.0/callfoo/param1/param2/param3
http://api.mydomain.com/v2.0/verifyfoo/param1/param2

Der Vorteil, den ich sehe, sind:

Wenn sich die Anrufe ändern, muss ich nicht meinen gesamten Client neu schreiben - nur die Teile, die von den geänderten Anrufen betroffen sind.Die Teile des Clients, die gut funktionieren, können so weiterarbeiten wie sie sind (wir haben viele Teststunden investiert, um sicherzustellen, dass sowohl die Client- als auch die Serverseite stabil sind.)Ich kann permanente oder nicht permanente Weiterleitungen für Anrufe verwenden, die sich geändert haben.Abwärtskompatibilität wäre ein Kinderspiel, da ich ältere Anrufversionen so lassen kann, wie sie sind.

Vermisse ich etwas? Bitte beraten.