REST接口定义

REST接口定义

REST即表述性状态传递（英文：representational state transfer），是Roy Fielding博士在2000年他的博士论文中提出来的一种软件架构风格。它是一种针对网络应用的设计和开发方式，可以降低开发的复杂性，提高系统的可伸缩性。

三种主流的web服务实现方案中，因为REST模式的web服务与复杂的SOAP和XML-RPC对比来讲明显更加简洁，越来越多的web服务开始采用REST风格设计和实现。

REST用来规范应用如何在HTTP层与API提供方进行数据交互 。REST描述了HTTP层里客户端和服务器端的数据交互规则；客户端通过向服务器端发送HTTP（s）请求，接收服务器的响应，完成一次HTTP交互。这个交互过程中，REST架构约定两个重要方面就是HTTP请求所采用的方法，以及请求的链接。

REST规范可以抽象位两个规则：

• 请求API的URL表示用来定位资源
• 请求METHOD表示对这个资源的操作（注：定位资源与操作资源分开，则URL中不能有任何动词）

比如，我们有一个friends接口，对于“朋友”我们有增删改查四种操作，怎么定义REST接口？
增加一个朋友，uri: generalcode.cn/va/friends 接口类型：POST
删除一个朋友，uri: generalcode.cn/va/friends 接口类型：DELETE
修改一个朋友，uri: generalcode.cn/va/friends 接口类型：PUT
查找一个朋友，uri: generalcode.cn/va/friends 接口类型：GET

上面我们定义的四个接口就是符合REST协议的，这几个接口都没有动词，只有名词friends，都是通过HTTP请求的接口类型来判断是什么业务操作。定义这样一套统一的接口，在web，ios，android三端都可以使用相同的接口，十分方便。