RESTFUL API

1.什么是RESTFUL API

RESTFUL API是目前比较成熟的一套互联网应用程序的API设计理论

2.URI代表一种资源

/users 用户资源
/users/{id}/books 某用户书籍资源

3.HTTP中Method代表对资源的操作

GET用来获取资源
POST用来新建资源（也可以用于更新资源）
PUT用来更新资源
DELETE用来删除资源

4.RESTFUL API接口定义实例

GET /users  获取用户列表
POST /users 创建用户
PUT /users/{id} 修改用户信息
DELETE /users/{id}  删除用户

GET /users/{id}/books   获取某用户书籍列表
POST /users/{id}/books  给某用户添加一本书籍      
PUT /users/{id}/books/{bookId}  修改某用户的某一本书籍信息
DELETE /users/{id}/books/{bookId}   删除某用户的某一本书籍

5.如果有多版本API，有2种处理方式

5.1 直接将版本号加在URL种，比如
    https://www.boomsecret.com/V1/users 版本V1
    https://www.boomsecret.com/V2/users 版本V2
5.2 在header中添加字段，比如
    Accept:application/json; version=v1 版本V1
    Accept:application/json; version=v2 版本V2