当API发生了变化,比如资源表述内容有新增项(字段或属性)或系统添加了新资源类型时,应使用不同的版本来区别对API的更改,为RESTful API添加版本有以下4种方式。
使用URI路径,如api/v1/users。
使用查询字符串,如api/users?version=v1。
使用自定义消息头,如Accept-version: v1。
使用Accept消息头,如Accept: application/json;v=2.0。
第7章将会详细介绍如何为API添加版本功能。