RESTful风格的特点和具体内容

一、RESTful风格内容

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

二、RESTful风格的特点

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

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值