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