RESTful使用风格及特点

本文介绍了RESTful风格的内容,包括域名部署、版本设置、路径规则、HTTP方法使用、过滤信息、状态码、错误信息和响应结果规范等。还阐述了其特点,如表现层、资源表现形式、状态转换,以及RESTful架构通过URL代表资源,用HTTP动词操作实现状态转换。

一、RESTful风格内容

1、域名:将api部署在专用域名下,或者将api放在主域名下。/2、版本:将API的版本号放在url中。
2、路径:路径表示API的具体网址。每个网址代表一种资源。资源作为网址,网址中不能有动词只能有名词,一般名词与数据库的表名对应。而且名词要使用复数
3、使用标准的HTTP方法:对于资源的具体操作类型,有HTTP动词表示。常用的HTTP动词有四个:
4、GET SELECT: 从服务器获取资源
5、POST CREATE:在服务器新建资源。
6、PUT UPDATE:在服务器更新资源
7、DELETE DELETE: 从服务器删除资源
8、过滤信息:如果资源数据较多,服务器不能讲所有数据一次全部返回给客户端。API应该提供参数,过滤返回结果。
9、状态码:服务器向用户返回的状态码和提示信息,常用的有:
200 OK 服务器成功返回用户请求的数据
201 CREATED:用户新建或修改数据成功
202 Accepted :表示请求已经进入后台排队
400 INVALID REQUEST:用户发出的请求有错误
401 Unauthorized: 用户没有权限
403 Forbidden: 访问被禁止
404 NOT FOUND :请求针对的是不存在的记录
406 Not Acceptable :用户请求的格式不正确
500 INTERNAL SERVER ERROR: 服务器发生错误
10、错误信息:一般来说服务器返回的错误信息,以键值对的形式返回
11、响应结果:针对不同结果,服务器向客户端返回的结果应符合以下规范
使用链接关联相关的资源:在返回响应结果时提供链接其他API的方法,使客户端很方便的获取相关联的信息
其他:服务器返回的数据格式应该尽量使用JSON,避免使用XML

二、RESTful风格的特点

具象的。一般指表现层,要表现的对象就是资源。比如客户端访问服务器,获取得数据就是资源。
表现:资源的表现形式。txt格式、html格式、json格式、jpg格式等。浏览器通过URL确定资源的位置,但是需要在HTTP请求头中,用Accept和Content-type字段指定,这两个字段是对资源表现的描述。
状态转换:客户端和服务器交互的过程中。在这个过程中,一定会有数据和状态的转化,这种转化叫做状态装换。其中,GET表示获取资源,POST表示新建资源,PUT表示更新资源,DELETE表示删除资源。
RESTful架构:每个URL代表一种资源;客户端和服务器之间,传递这种资源的某种表现层;客户端通过四个http动词,对服务器资源进行操作,实现表现层状态转换。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值