API版本控制
最后更新于:2022-04-02 03:09:52
[TOC]
## 何时进行版本控制
只有在进行重大更改时才需要对API进行升级。突破性变化包括:
1. 一个或多个调用的响应数据格式的变化
2. 响应类型的更改(即将整数更改为float)
3. 删除API的任何部分。
## 如何进行版本控制
### 一.URI版本控制
```
http://api.example.com/v1
http://apiv1.example.com
```
### 二.使用自定义请求标头进行版本控制
自定义标头(例如,Accept-version)允许您在版本之间保留URI
例如
```
Accept-version: v1
Accept-version: v2
```
### 三.使用Accept标头进行版本控制
```
Accept: application/vnd.example.v1+json
Accept: application/vnd.example+json;version=1.0
```
';