1 客戶端請求的API版本和服務器端API版本不是一一對應的
2 客戶端請求的API版本可能爲1.0, 1.1, 2.0, 2.1…… 而服務器端最多維護3個大版本,比如 1.x, 2.x, 3.x,當超過三個版本,則廢棄掉最低的版本,同時強制客戶端升級。
3 服務器端維護的版本(最多三個)是通過不同二級域名來訪問的,
比如:1.x: https://v1.api.your-domain.com
2.x: https://v2.api.your-domain.com
3.x: https://v3.api.your-domain.com
4 小版本迭代(比如:1.0升級到1.1,服務器端對應提供的API爲1.x), 可能面臨API新增和廢棄的情況,如果是API廢棄,則在註釋一欄明確標明 @deprecated,已便下一個大版本升級的時候將其從代碼中移除。