从what,why,how几个方面来讲解restfulAPI。在解读restfulAPI之前,先说一说什么是rest,rest并不是单纯的一个单词,而是Representational State Transfer的缩写, 直接翻译:表现层状态转移,如果不懂,没关系,因为他省略了最主要的主语,目前我认为rest最好的中文翻译是“资源在网络中以某种表现形式进行状态转移”。下面对每个单词做一个简单的解释,有利于我们更好的理解rest。
Resource:资源,即数据。database中存储的信息;
Representational:某种表现形式,比如用JSON,XML,JPEG等;
State Transfer:状态变化。通过HTTP动词实现。post,delete,put,get。
了解了rest,接下来我们来聊一聊restfulAPI,刚刚讲到的rest只是描述在网络中client和server的一种交互形式;rest本身不实用,实用的是如何设计 RESTful API(REST风格的网络接口);
Server提供的RESTful API中,URL中只使用名词来指定资源,原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。比如:http://api.xv.com/v1/orders: 获取订单列表; api.xv.com/v1/friends: 获取好友列表;
用HTTP协议里的动词来实现资源的添加,修改,删除等操作。即通过HTTP动词来实现资源的状态扭转,GET 用来获取资源,POST 用来新建资源,PUT 用来更新资源,DELETE 用来删除资源。
比如:DELETE http://http://api.xv.com/v1/orders 删除订单 ,POST http://api.qc.com/v1/friends: 添加好友
对restfulAPI有了简单的认识,那么我们为什么要使用rest风格的API设计呢?我们都知道早期的网页都是前端后端融在一起的,比如之前的PHP,JSP等。在之前的桌面时代问题不大,但是近年来移动互联网的发展,各种类型的Client层出不穷,RESTful可以通过一套统一的接口为 Web,iOS和Android提供服务。另外对于广大平台来说,比如Facebook platform,微博开放平台,微信公共平台等,它们不需要有显式的前端,只需要一套提供服务的接口,于是RESTful更是它们最好的选择。