resfulAPI规范的理解
-
首先要了解什么是resfulAPI ,它其实就是个规范。为什么要用它?为了让以后接手你代码的人,能很快的看明白和接手(规范就是这个目的)。主要分为6个部分,为URI(资源路径)、HTTP动词、状态码、错误处理、过滤信息、返回结果。
-
我们以前的请求方式通常为两种 get post ,在规范中,我们又加了两种请求方式,为PUT 和DELETE ,(看图,这个属于HTTP动词)
-
在规范中,我们的传输格式必须为json格式,(返回结果,下面会介绍json格式的好处和坏处)
-
状态码:这个大家一定很熟悉了,就是成功是200,400用户发送请求有错误,服务器错误都是5开头之类的,
-
过滤信息,常用于排序、筛选、后端的分页吧,如果记录很多,服务器是不可能把10W条数据都返回回去的,这时候就需要API来提供参数,过滤返回结果
-
错误处理,状态码是4开头的,返回一般用“error”作为健名,错误信息为键值“参数错误”
</