Ich habe es gewohnt, die Versionsnummer in der URL selbst (/v1/) zu haben. Ich persönlich denke, dass dies ein viel sauberer Ansatz ist. Auf diese Weise muss der Endbenutzer (oder der Entwickler) HTTP -Header nicht verarbeiten und kann einfach die REST -API/den Aufruf ändern, um nach Bedarf auf verschiedene Versionen der API zuzugreifen.
Ich denke, dass es auch möglich ist, dass einige der HTTP -APIs in verschiedenen Sprachen möglicherweise keine volle Unterstützung für HTTP -Header haben, sodass Sie immer die API für den Endbenutzer zur Verfügung stellen. Das Wiederumschreiben der URL ist der einfachste Weg, und es sollte mit allem funktionieren, was HTTP da draußen unterstützt.
Wenn die API -Version mithilfe der URL angegeben werden kann, ermöglicht es schließlich einfache Tests mit einem Webbrowser. Wenn Sie die Versionierung in einen HTTP -Header einbeziehen, muss der Entwickler eine Programmiersprache verwenden, um Tests zu testen.