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 ```
';