url参数
URL 参数是追加到 URL 上的一个名称/值对。参数以问号 (?) 开始并采用 name=value 的格式。如果存在多个 URL 参数,则参数之间用一个 (&) 符隔开
Restful API设计
- 尽量不用url参数
- 用HTTP方法表示操作类型(使用post delete put/patch get做增删改查),充分利用HTTP方法的语义
怎样做到尽量不使用url参数?
传统API设计:/api/list?pageIndex=2
Restful API设计:/api/list/2
怎样利用HTTP方法的语义?
比如,通过用户的ID获取个人信息,显然要使用GET方法。按照传统API设计我们就这么写地址接口:https://www.imooc.com/api/http/getUser?id=1。
这个地址就可以当作前后端的一个接口,前后端通过这个地址完成通信,前端发送对这个地址的请求,后端把数据放到这个地址上
对于注册/修改/删除用户的接口,按照传统API设计就得这么来写
注册新用户,使用 POST 方法
https://www.imooc.com/api/http/addUser
修改一个用户,使用 POST 方法
https://www.imooc.com/api/http/modifyUser
删除一个用户,使用 POST 方法
https://www.imooc.com/api/http/deleteUser
我们对user的增删改查就是用了四种不同的接口,后端写起来会很麻烦
怎么避免这种麻烦?使用Restful接口设计,充分利用HTTP方法的语义
GET
https://www.imooc.com/api/http/user/1
POST
https://www.imooc.com/api/http/user
PUT
https://www.imooc.com/api/http/user/2
DELETE
https://www.imooc.com/api/http/user/3
接口设计的一样。但后端可以获取到前端的请求方式get/post/put/delete。后端如果获取到的前端方法是get,他就知道你前端是想获取到user的数据,获取的哪条数据,则由
http/user/1 user后面的参数来决定
接口设计的一样。后端通过获取到的不同的方法,来做不同的事情