什么是RESTful API?

一. 定义

Rest的全称是Representational State Transfer,2000年由Roy Fielding发表在他的博士论文中,首次提出了Restful的概念。Restful 做为一种接口的设计规则,基于HTTP协议 ,可以使用XML格式JSON格式传输数据。对于使用restful这套规则定义开发的接口,我们称之为Restful API
关于Restful的具体表现形式,简单可以用一句话概括:URL定位资源,使用HTTP请求GET、POST、PUT、DELETE等)对资源进行操作。

二. 设计原则与规范

Restfu是典型的基于HTTP的协议 ,它有哪些设计 原则和规范呢?

  1. URL与资源:资源表示网络上的一个实体对象,可以是一个资产、一首歌曲或一种服务,资源总是以一定的格式来表现自己。通过定义一个URL指向资源,要访问资源时,只需要通过该资源所属的URL进行请求访问即可。一般来说,接口名称只能用名词,不可以用动词,根据HTTP的请求来进行操作,这样可以不在URL不暴露操作方式。
    例如:http://www.kk.com/api/books 表示一个资源(书本)对象
  2. 统一接口规范:Restful架构应该遵循统一接口原则 ,统一接口包含了一组固定的预定义操作,不管是什么样的资源,都通过方式进行资源访问 。在Restful API架构中,客户端通过HTTP协议,使用GETPOSTPUTDELETE4种请求方式对服务端资源进行操作,GET用于获取资源,POST用来新建资源,PUT用来更新资源,DELETE用于删除资源。
  3. 无状态:从客户端到服务端的每个请求都是独立 ,请求中必须包含需要的所有信息,这也代表服务器不需要储存任何上下文信息,对于客户端来说,第一次请求和第100次请求都是相同的。在Restful 架构中,尽量避免使用session的方式,而是由客户端自己标识会话状态(token)。
  4. 除以上的操作规范外,另外还有一些要求, 包括:
    url不能使用大写字母;
    不使用文件扩展名,如.php等;
    可在url中增加api版本号等;
    文本返回必须为Json格式。

三. URL格式标准、HTTP动词、参数命名规范

3.1 下面我们通过几个示例来了解下Restful API的格式定义方式

  1. 查看
    GET http://api.xxx.com/users 查看所有用户信息
    GET http://api.xxx.com/users/id 查看该id的用户信息
    GET http://api.xxx.com/users?age=
  • 0
    点赞
  • 8
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值