版本控制和版本之间的转换可能是设计和维护 API 的更具挑战性的一个方面。因此，最好从一开始就制定一些机制来预防这种情况。
为了防止对用户造成意外、破坏性更改，最好要求为所有请求指定一个版本。应避免使用默认版本，因为它们在未来很难更改。
最好在标头中提供版本规范以及其他元数据，使用Accept带有自定义内容类型的标头，例如：
Accept: application/vnd.heroku+json; version=3