要弄清楚什么是RESTful API,首先要弄清楚什么是REST。REST -- REpresentational State Transfer,英语的直译就是“表现层状态转移”。若是看这个概念,估计没几我的能明白是什么意思。那下面就让我来用一句人话解释一下什么是RESTful:URL定位资源,用HTTP动词(GET,POST,PUT,DELETE)描述操做。前端
Resource:资源,即数据。
Representational:某种表现形式,好比用JSON,XML,JPEG等;
State Transfer:状态变化。经过HTTP动词实现。服务器
因此RESTful API就是REST风格的API。 那么在什么场景下使用RESTful API呢?在当今的互联网应用的前端展现媒介很丰富。有手机、有平板电脑还有PC以及其余的展现媒介。那么这些前端接收到的用户请求统一由一个后台来处理并返回给不一样的前端确定是最科学和最经济的方式,RESTful API就是一套协议来规范多种形式的前端和同一个后台的交互方式。网络
RESTful API由后台也就是SERVER来提供前端来调用。前端调用API向后台发起HTTP请求,后台响应请求将处理结果反馈给前端。也就是说RESTful 是典型的基于HTTP的协议。那么RESTful API有哪些设计原则和规范呢?.net
1,资源。首先是弄清楚资源的概念。资源就是网络上的一个实体,一段文本,一张图片或者一首歌曲。资源老是要经过一种载体来反应它的内容。文本能够用TXT,也能够用HTML或者XML、图片能够用JPG格式或者PNG格式,JSON是如今最经常使用的资源表现形式。设计
2,统一接口。RESTful风格的数据元操CRUD(create,read,update,delete)分别对应HTTP方法:GET用来获取资源,POST用来新建资源(也能够用于更新资源),PUT用来更新资源,DELETE用来删除资源,这样就统一了数据操做的接口。blog
3,URI。能够用一个URI(统一资源定位符)指向资源,即每一个URI都对应一个特定的资源。要获取这个资源访问它的URI就能够,所以URI就成了每个资源的地址或识别符。通常的,每一个资源至少有一个URI与之对应,最典型的URI就是URL。接口
4,无状态。所谓无状态即全部的资源均可以URI定位,并且这个定位与其余资源无关,也不会由于其余资源的变化而变化。有状态和无状态的区别,举个例子说明一下,例如要查询员工工资的步骤为第一步:登陆系统。第二步:进入查询工资的页面。第三步:搜索该员工。第四步:点击姓名查看工资。这样的操做流程就是有状态的,查询工资的每个步骤都依赖于前一个步骤,只要前置操做不成功,后续操做就没法执行。若是输入一个URL就能够获得指定员工的工资,则这种状况就是无状态的,由于获取工资不依赖于其余资源或状态,且这种状况下,员工工资是一个资源,由一个URL与之对应能够经过HTTP中的GET方法获得资源,这就是典型的RESTful风格。图片
说了这么多,到底RESTful长什么样子的呢?资源
GET:http://www.xxx.com/source/id 获取指定ID的某一类资源。例如GET:http://www.xxx.com/friends/123表示获取ID为123的会员的好友列表。若是不加id就表示获取全部会员的好友列表。开发
POST:http://www.xxx.com/friends/123表示为指定ID为123的会员新增好友。其余的操做相似就不举例了。
RESTful API还有其余一些规范。1:应该将API的版本号放入URL。GET:http://www.xxx.com/v1/friend/123。或者将版本号放在HTTP头信息中。我我的以为要不要版本号取决于本身开发团队的习惯和业务的须要,不是强制的。2:URL中只能有名词而不能有动词,操做的表达是使用HTTP的动词GET,POST,PUT,DELETEL。URL只标识资源的地址,既然是资源那就是名词了。3:若是记录数量不少,服务器不可能都将它们返回给用户。API应该提供参数,过滤返回结果。?limit=10:指定返回记录的数量、?page=2&per_page=100:指定第几页,以及每页的记录数。