restful.gif
要弄清楚什么是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方法与之对应。
未命名文件.png
-
URI。统一资源标识符，它可以唯一标识一个资源。注意到，URL(统一资源定位符)是一种URI，因为它可以唯一标志资源。但URL != URI。应该说URL 是URI的子集。因为URL使用路径来唯一标识资源，这只是唯一标识资源的一种方式。还可以用一个唯一编号来标识资源，如example.html.fuce2da23。只不过这种方式并不被广泛使用。总之，要在概念上对URL和URI有所区分。
-
无状态。 所谓无状态是指所有资源都可以用URI定位，而且这个定位与其他资源无关，不会因为其他资源的变动而变化。这里引入一个幂等性的概念：无论一个操作被执行一次还是多次，执行后的效果都相同。比如对某资源发送GET请求，如果访问一次和访问十次获得的数据一样，那么就说这个请求具有幂等性。
-
URL中只能有名词，不能出现动词。这是因为在REST要求对资源的操作由HTTP 方法给出，而方法是由HTTP 请求报文头部给出的，自然不需要在URL中暴露操作方式。
还有一些属于业务决定型规则，比如应该将版本加到URL中，对返回记录进行限制过滤。不是强制的，但是比较建议这么做。
网友评论