Resultful API规范

Resultful API规范

什么是resultful:

REST代表的是一种软件架构风格,REST从资源的角度类审视整个网络,它将分布在网络中某个节点的资源通过URL进行标识,客户端应用通过URL来获取资源的表征,获得这些表征致使这些应用转变状态 所有的数据,不过是通过网络获取的还是操作(增删改查)的数据,都是资源,将一切数据视为资源是REST区别与其他架构风格的最本质属性。

resultful API规范: 1.根据method的不同,做不同的操作,示例:

   'GET':
 '获取数据'
     'POST':
 '创建数据'
     'PUT':
 '更新数据'
     'PATCH':
 '对PUT的补充,局部更新'
     'DELETE':
 '删除数据'

2.返回结果,针对不同操作,服务器向用户返回的结果应该符合以下规范 GET:向数据库发索取数据的请求,从而来获取信息,该请求就像数据库的select操作一样,只是用来查询一下数据.

GET /order/ 返回资源对象的列表(数组) GET /order/1/ 返回单个资源对象

POST /order/ 返回新生成的资源对象,同PUT请求类似,都是向服务器端发送数据的,但是该请求会改变数据的种类等资源,就像数据库的insert操作一样,会创建新的内容.

PUT /order/1/ 返回完整的资源对象,向服务器端发送数据的,从而改变信息,该请求就像数据库的update操作一样,用来修改数据的内容,但是不会增加数据的种类等,也就是说无论进行多少次PUT操作,其结果并没有不同.

PATCH /order/1/ 返回完整的资源对象,对PUT方法的补充,用来对已知资源进行局部更新,PATCH是幂等的.

DELETE /order/1/ 返回一个空文档,用来删除某一个资源的,该请求就像数据库的delete操作

resultful其实本质上就是一个规范,定义一些规范让我们写API的时候更好作区分,让后台更好作处理,让我们的前台更好的记住这些url,说白了就是在这个url体现出对这个API的操作。遵循这个规范,就是让大家在协同开发的时候,相互之间更加统一了。 原来我们没用API之前,我们用的是get,post…全都能实现,但只不过url得保存好多个,学了resultful API之后,才渐渐的去使用,但使用的过程中,也会发现有的能适用,有的不能适用。

file 扫描下方二维码,关注本人公众号:filefile ___中国好码农

猜你喜欢