从事web开发工作有一小段时间，REST风格的接口，这样的词汇总是出现在耳边，然后又没有完全的理解，您是不是有和我相同的疑问呢？那我们一起来一探究竟吧！

就是用URL定位资源，用HTTP描述操作。

知乎大神Ivony有句话说的好：

URL定位资源，用HTTP动词（GET,POST,DELETE,DETC）描述操作。

咱们不解释REST是哪几个单词的首字母，说了也不知道，翻译成中文就是表现层状态转移，我是弄不懂。

在设计web接口的时候，REST主要是用于定义接口名，接口名一般是用名次写，不用动词，那怎么表达“获取”或者“删除”或者“更新”这样的操作呢——用请求类型来区分。

比如，我们有一个friends接口，对于“朋友”我们有增删改查四种操作，怎么定义REST接口？

增加一个朋友，uri: generalcode.cn/v1/friends 接口类型：POST

删除一个朋友，uri: generalcode.cn/va/friends 接口类型：DELETE

修改一个朋友，uri: generalcode.cn/va/friends 接口类型：PUT

查找朋友，uri: generalcode.cn/va/friends 接口类型：GET

上面我们定义的四个接口就是符合REST协议的，请注意，这几个接口都没有动词，只有名词friends，都是通过Http请求的接口类型来判断是什么业务操作。

举个反例：generalcode.cn/va/deleteFriends 该接口用来表示删除朋友，这就是不符合REST协议的接口。

一般接口的返回值是JSON或者XML类型的，笔者在互联网的工作经验一般都是JSON类型的。

用HTTP Status Code传递Server的状态信息。比如最常用的 200 表示成功，500 表示Server内部错误，403表示Bad Request等。（反例：传统web开发返回的状态码一律都是200，其实不可取。）

那这种风格的接口有什么好处呢？前后端分离。前端拿到数据只负责展示和渲染，不对数据做任何处理。后端处理数据并以JSON格式传输出去，定义这样一套统一的接口，在web，ios，android三端都可以用相同的接口，是不是很爽？！

要弄清楚什么是RESTful API，首先要知道REST是什么。

REST，表示性状态转移(representation state transfer)。简单来说，就是用URI表示资源，用HTTP方法(GET, POST, PUT, DELETE)表征对这些资源的操作。

Resource: 资源，即数据，存在互联网上的可被访问的实体Representation: 数据的某种表现形式，如HTML, JSON。State Transfer:状态变化，HTTP方法实现

RESTful API 就是REST风格的API。现在终端平台多样，移动、平板、PC等许多媒介向服务端发送请求后，如果不适用RESTful API，需要为每个平台的数据请求定义相应的返回格式，以适应前端显示。但是RESTful API 要求前端以一种预定义的语法格式发送请求，那么服务端就只需要定义一个统一的响应接口，不必像之前那样解析各色各式的请求。

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

资源。首先要明确资源就是网络上的一个实体，可以是文本、图片、音频、视频。资源总是以一定的格式来表现自己。文本用txt、html;图片用JPG、JPEG等等。而JSON是RESTful API中最常用的资源表现格式。

统一接口。对于业务数据的CRUD，RESTful 用HTTP方法与之对应。

简单理解就是用URL定位资源，用HTTP描述操作。

或者理解为用URL定位资源，用HTTP动词(GET,POST,DELETE,DETC)描述操作。

官方定义是一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。

以web开发举例

在设计web接口的时候，REST主要是用于定义接口名，接口名一般是用名词写，不用动词，那怎么表达“获取”或者“删除”或者“更新”这样的操作呢——用请求类型来区分。

比如，我们有一个students接口，对于“学生”我们有增删改查四种操作，怎么定义REST接口？

增加一个学生，uri: http://testcode.com/school/students 接口类型：POST

删除一个朋友，uri: http://testcode.com/school/students 接口类型：DELETE

修改一个朋友，uri: http://testcode.com/school/students 接口类型：PUT

查找朋友，uri: http://testcode.com/school/students 接口类型：GET

上面我们定义的四个接口就是符合REST协议的，请注意，这几个接口都没有动词，只有名词students，都是通过Http请求的接口类型来判断是什么业务操作。

举个反例

uri: http://testcode.com/school/addStudents 该接口用来表示增加学生，这就是不符合REST协议的接口。

建议

用HTTP Status Code传递Server的状态信息。比如最常用的 200 表示成功，500 表示Server内部错误，403表示Bad Request等。(反例：传统web开发返回的状态码一律都是200，其实不可取。)

REST风格接口意义

前后端分离。前端拿到数据只负责展示和渲染，不对数据做任何处理。后端处理数据并以JSON格式传输出去，定义这样一套统一的接口，在web，ios，android三端都可以用相同的接口，节约开发成本以及便于同一调试。

网上整理的对于Rest和Restful api的理解

一、什么是Rest?

REST不是"rest"这个单词，而是几个单词缩写 -- REpresentational State Transfer 直接翻译：表现层状态转移，但这个翻译正常人根本看不懂，找到的一种最好理解的说法是，URL定位资源，用HTTP动词（GET,POST,DELETE,DETC）描述操作。

二、Restful api接口有什么特征？

REST描述的是在网络中client和server的一种交互形式；REST本身不实用，实用的是如何设计 RESTful API（REST风格的网络接口）。

1.URL的根路径

http://api.chesxs.com/v1

2.需要有api版本信息

http://api.chesxs.com/v1

3.URL中只使用名词指定资源，不用动词，且推荐使用复数

服务（Server）提供的RESTful API中，URL中只使用名词来指定资源，原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。比如：

http://api.chesxs.com/v1/cars // 获取某个账户下的车辆列表http://api.chesxs.com/v1/fences // 获取某个账户下的围栏列表

4. 用HTTP协议里的动词来实现资源的添加，修改，删除等操作。即通过HTTP动词来实现资源的状态扭转

 

GET 用来获取资源，POST 用来新建资源（也可以用于更新资源）。比如：POST http://api.chesxs.com/v1/car: 添加车辆PUT 用来更新资源，DELETE 用来删除资源。比如：DELETE http://api.chesxs.com/v1/cars 删除某辆车 （在http parameter指定好友id）UPDATE http://api.chesxs.com/v1/fence 更新围栏信息错误使用： GET http://api.chesxs.com/v1/deleteCar 删除车辆

5.GET应该是安全的，不会改变资源状态

 这个应该很好理解，get的时候就只是获取资源，而不涉及添加、更新、删除资源。

6.使用正确的HTTP Status Code返回状态码

常用的有404，200，500，400等等。

7.过滤信息

如果记录数量很多，服务器不可能都将它们返回给用户。API应该提供参数，过滤返回结果。

下面是一些常见的参数。

?limit=10：指定返回记录的数量?offset=10：指定返回记录的开始位置。?page=2&per_page=100：指定第几页，以及每页的记录数。?sortby=name&order=asc：指定返回结果按照哪个属性排序，以及排序顺序。?producy_type=1：指定筛选条件

8.规范返回的数据

为了保障前后端的数据交互的顺畅，建议规范数据的返回，并采用固定的数据格式封装。

接口返回模板：

{status:0,data:{}||[],msg:’’}

 

总结，看一个标准的restful api要可以做到

看Url就知道要操作的资源是什么，是操作车辆还是围栏看Http Method就知道操作动作是什么，是添加（post）还是删除（delete）看Http Status Code就知道操作结果如何，是成功（200）还是内部错误（500）

REST 指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful

RESTful API就是REST风格的API