rest api和restful,什么是REST API
rest api和restful,什么是REST API详细介绍
本文目录一览： 如何理解rest和restful，什么是restfulAPI？
简单理解一
就是用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三端都可以用相同的接口，节约开发成本以及便于同一调试。
什么是RESTfulAPI
什么是RESTfulAPI？RESTfulAPI是什么，以及如何使用它？RESTfulAPI是一种建立在HTTP协议和标准Web技术之上的API设计风格。它允许客户端和服务器之间进行交互，并利用现有的通信协议传输数据。与SOAP等其他传输协议相比，RESTfulAPI具有更好的可伸缩性和可维护性。要了解RESTfulAPI，必须先理解以下三个概念：1.资源：指的是可通过API访问的任何内容，例如网站上的文章、图像、评论等。对于每个资源，应该确定它的唯一标识符，以便轻松地与其交互。2.HTTP方法：指的是客户端可用于访问资源的方式，常用的方法有GET、POST、PUT和DELETE。3.表示：指的是服务器返回资源的表现形式，可以是HTML、XML、JSON或其他格式。RESTfulAPI的核心思想是通过HTTP方法以及URI对资源进行增删改查操作。例如：1.GET方法：用于获取资源，如从服务器检索网站上的文章或图像。示例URI：/articles/123。2.POST方法：用于创建新资源，如在网站上发布新文章或评论。示例URI：/articles。3.PUT方法：用于更新现有资源，例如更新文章的标题或内容。示例URI：/articles/123。4.DELETE方法：用于删除资源，例如删除文章或评论。示例URI：/articles/123。在实现RESTfulAPI时，应遵循以下几个原则：1.状态应该保存在客户端，而不是服务器上。2.必须使用标准HTTP方法和状态代码3.返回的表示应该是可缓存的。4.URI应该唯一标识每个资源。5.与服务器端无状态通信，每次请求都应该包括所有必要的信息。正确定义和实现RESTfulAPI，可以帮助开发人员更好地构建可扩展的分布式应用程序。此外，RESTfulAPI还可以被用于构建web服务，使其更加安全和高效。
restful api接口规范是什么？
REST（REpresentationStateTransfer）描述了一个架构样式的网络系统，比如web应用程序。
一般依赖于HTTP认证，HTTP认证有几种：basic，digest，token，这些都有标准的实现的开源包需要主要的是这个认证的帐号跟你业务的帐户实际是不一样的。REST属于webService一种，安全是后台服务的安全，因此不需要实际的业务帐号，通常是系统keyStore证书库里的账户。
RESTFUL特点包括：
1、每一个URI代表1种资源。
2、客户端使用GET、POST、PUT、DELETE4个表示操作方式的动词对服务端资源进行操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源。
3、通过操作资源的表现形式来操作资源。
4、资源的表现形式是XML或者HTML。
5、客户端与服务端之间的交互在请求之间是无状态的，从客户端到服务端的每个请求都必须包含理解请求所必需的信息。
什么是REST API
REST APL指一组架构约束条件和原则，满足约束条件和原则的应用程序设计。架构，软件体系结构分为三部分：构建，用于描述计算机；连接器，用于描述构建的链接部分；配置将构建和连接器组成有机整体。
拓展资料：rest，即REST（RepresentationalStateTransfer表述性状态转移）是一种针对网络应用的设计和开发方式，可以降低开发的复杂性，提高系统的可伸缩性。现如今在三种主流的Web服务实现方案中，因为REST模式的Web服务与复杂的SOAP和XML-RPC开始采用REST风格设计和实现。例如，Amazon.com提供接近REST风格的Web服务进行图书查找；雅虎提供的Web服务也是REST风格的。
一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。
拓展内容：
原则条件：
REST 指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful。
Web 应用程序最重要的 REST 原则是，客户端和服务器之间的交互在请求之间是无状态的。从客户端到服务器的每个请求都必须包含理解请求所必需的信息。如果服务器在请求之间的任何时间点重启，客户端不会得到通知。此外，无状态请求可以由任何可用服务器回答，这十分适合云计算之类的环境。客户端可以缓存数据以改进性能。
定义规则：
REST中的资源所指的不是数据，而是数据和表现形式的组合，比如“最新访问的10位会员”和“最活跃的10位会员”在数据上可能有重叠或者完全相同，而由于他们的表现形式不同，所以被归为不同的资源，这也就是为什么REST的全名是Representational State Transfer的原因。
资源标识符就是URI(Uniform Resource Identifier)，不管是图片，Word还是视频文件，甚至只是一种虚拟的服务，也不管你是XML（标准通用标记语言下的一个子集）格式、txt文件格式还是其它文件格式，全部通过 URI对资源进行唯一的标识。
一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。
拓展内容：
原则条件：
REST 指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful。
Web 应用程序最重要的 REST 原则是，客户端和服务器之间的交互在请求之间是无状态的。从客户端到服务器的每个请求都必须包含理解请求所必需的信息。如果服务器在请求之间的任何时间点重启，客户端不会得到通知。此外，无状态请求可以由任何可用服务器回答，这十分适合云计算之类的环境。客户端可以缓存数据以改进性能。
定义规则：
REST中的资源所指的不是数据，而是数据和表现形式的组合，比如“最新访问的10位会员”和“最活跃的10位会员”在数据上可能有重叠或者完全相同，而由于他们的表现形式不同，所以被归为不同的资源，这也就是为什么REST的全名是Representational State Transfer的原因。
资源标识符就是URI(Uniform Resource Identifier)，不管是图片，Word还是视频文件，甚至只是一种虚拟的服务，也不管你是XML（标准通用标记语言下的一个子集）格式、txt文件格式还是其它文件格式，全部通过 URI对资源进行唯一的标识。
REST的全拼是（REpresentational State Transfer，表述性状态转移）。REST指的是一组架构约束条件和原则，满足这些约束条件和原则的应用程序设计就是RESTful。
REST指一组架构约束条件和原则，满足约束条件和原则的应用程序设计。架构，软件体系结构分为三部分：构建，用于描述计算机；连接器，用于描述构建的链接部分；配置将构建和连接器组成有机整体。
Rest API，无论它的名字多么高大上，它本质还是一个HTTP请求，POST也好，GET也罢，都是不同的数据提交方式。所以，能够决定一个Rest API的也就：URI、参数、请求方式、请求头等。API平台的架构，其实和底层公司的业务系统架构有着密切的关系，基于一个好的系统架构写一个Rest API平台基本是水到渠成的。
Rest API 开发 学习笔记 概述
REST 从资源的角度来观察整个网络，分布在各处的资源由URI确定，而客户端的应用通过URI来获取资源的表示方式。获得这些表徵致使这些应用程序转变了其状态。随着不断获取资源的表示方式，客户端应用不断地在转变着其状态，所谓表述性状态转移（Representational State Transfer）。
这一观点不是凭空臆造的，而是通过观察当前Web互联网的运作方式而抽象出来的。Roy Fielding 认为，
“设计良好的网络应用表现为一系列的网页，这些网页可以看作的虚拟的状态机，用户选择这些链接导致下一网页传输到用户端展现给使用的人，而这正代表了状态的转变。”
REST是设计风格而不是标准。REST通常基于使用HTTP，URI，和XML以及HTML这些现有的广泛流行的协议和标准。
资源是由URI来指定。
对资源的操作包括获取、创建、修改和删除资源，这些操作正好对应HTTP协议提供的GET、POST、PUT和DELETE方法。
通过操作资源的表现形式来操作资源。
资源的表现形式则是XML或者HTML，取决于读者是机器还是人，是消费web服务的客户软件还是web浏览器。当然也可以是任何其他的格式。
REST的要求
客户端和服务器结构
连接协议具有无状态性
能够利用Cache机制增进性能
层次化的系统
随需代码 - Javascript （可选）
RESTful Web 服务
RESTful Web 服务（也称为 RESTful Web API）是一个使用HTTP并遵循REST原则的Web服务。它从以下三个方面资源进行定义：URI，比如：http://example.com/resources/。
§ Web服务接受与返回的互联网媒体类型，比如：JSON，XML ，YAML 等。
§ Web服务在该资源上所支持的一系列请求方法（比如：POST，GET，PUT或DELETE）。
该表列出了在实现RESTful Web 服务时HTTP请求方法的典型用途。
HTTP 请求方法在RESTful Web 服务中的典型应用
资源
GET
PUT
POST
DELETE
一组资源的URI，比如http://example.com/resources/
列出 URI，以及该资源组中每个资源的详细信息（后者可选）。
使用给定的一组资源替换当前整组资源。
在本组资源中创建/追加一个新的资源。 该操作往往返回新资源的URL。
删除 整组资源。
单个资源的URI，比如http://example.com/resources/142
获取 指定的资源的详细信息，格式可以自选一个合适的网络媒体类型（比如：XML、JSON等）
替换/创建 指定的资源。并将其追加到相应的资源组中。
把指定的资源当做一个资源组，并在其下创建/追加一个新的元素，使其隶属于当前资源。
删除 指定的元素。
PUT 和 DELETE 方法是幂等方法。GET方法是安全方法 （不会对服务器端有修改，因此也是幂等的）。
不像基于SOAP的Web服务，RESTful Web服务并没有的“正式”标准。 这是因为REST是一种架构，而SOAP只是一个协议。虽然REST不是一个标准，但在实现RESTful Web服务时可以使用其他各种标准（比如HTTP，URL，XML，PNG等）。
REST的优点
可以利用缓存Cache来提高响应速度
通讯本身的无状态性可以让不同的服务器的处理一系列请求中的不同请求，提高服务器的扩展性
浏览器即可作为客户端，简化软件需求
相对于其他叠加在HTTP协议之上的机制，REST的软件依赖性更小
不需要额外的资源发现机制
在软件技术演进中的长期的兼容性更好
http://wenku.baidu.com/view/74f6e4bec77da26925c5b036.html.(可以看一下）
REST 是REpresentational State Transfer的缩写，字面的翻译是表现层状态转移。
RESTful API就是REST风格的网络接口，REST描述的是在网络中client和server的一种交互形式；REST本身不实用，实用的是如何设计。
Server提供的RESTful API中，URL中只使用名词来指定资源，原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。
拓展资料:
REST指一组架构约束条件和原则，满足约束条件和原则的应用程序设计。架构，软件体系结构分为三部分：构建，用于描述计算机；连接器，用于描述构建的链接部分；配置将构建和连接器组成有机整体。
web基本技术：URI（统一资源标示符）HTTP（超文本传输协议）（post、get、put、delete） Hypertext。
1、每个资源都应该有唯一的一个标识
2、使用标准的方法更改资源的状态
3、request和response的自描述
4、资源多重表述
5、无状态服务
用HTTP协议里的动词来实现资源的添加，修改，删除等操作。即通过HTTP动词来实现资源的状态扭转：
GET 用来获取资源
POST 用来新建资源（也可以用于更新资源）
PUT 用来更新资源，
DELETE 用来删除资源。
一个好的RESTfulAPI，具备特征
一个好的RESTfulAPI，应该具备以下特征：
这个API应该是对浏览器友好的，能够很好地融入Web，而不是与Web格格不入。
1.浏览器是最常见和最通用的REST客户端。好的RESTfulAPI应该能够使用浏览器HTML完成所有的测试（不需要使用编程语言）。这样的API还可以很方便地使用各种自动化的Web功能测试、性能测试工具来做测试。Web前端应用（基于浏览器的RIA应用、移动App等等）也可以很方便地将多个RESTfulAPI的功能组合起来，建造Mashup类的应用。
这个API中所包含的资源和对于资源的操作，应该是直观和容易理解的，并且符合HTTP协议的要求。
REST开发又被称作“面向资源的开发”，这说明对于资源的抽象，是设计RESTfulAPI的核心内容。RESTfulAPI建模的过程与面向对象建模类似，是以名词为核心的。这些名词就是资源，任何可命名的抽象概念都可以定义为一个资源。而HTTP协议并不是一种传输协议，它实际提供了一个操作资源的统一接口。对于资源的任何操作，都应该映射到HTTP的几个有限的方法（常用的有GET/POST/PUT/DELETE四个方法，还有不常用的PATCH/HEAD/OPTIONS方法）上面。所以RESTfulAPI建模的过程，可以看作是具有统一接口约束的面向对象建模过程。
按照HTTP协议的规定，GET方法是安全且幂等的，POST方法是既不安全也不幂等的（可以用来作为所有写操作的通配方法），PUT、DELETE方法都是不安全但幂等的。将对资源的操作合理映射到这四个方法上面，既不过度使用某个方法（例如过度使用GET方法或POST方法），也不添加过多的操作以至于HTTP的四个方法不够用。
2.如果发现资源上的操作过多，以至于HTTP的方法不够用，应该考虑设计出更多的资源。设计出更多资源（以及相应的URI）对于RESTfulAPI来说并没有什么害处。
这个API应该是松耦合的。
RESTfulAPI的设计包括了三个循序渐进、由低到高的层次：资源抽象、统一接口、超文本驱动。正是这三个层次确保了RESTfulAPI的松耦合性。
3.当设计面向互联网的API时，松耦合变成了一种“必须有”的强需求。紧耦合的API非常脆弱，一旦公布出去，服务器端和客户端都无法持续进化。尤其是服务器端，公布出去的接口根本不敢改，改了之后，几乎所有客户端应用立即无法正常工作。REST这种架构风格就是紧耦合API的解毒剂，这个话题可以谈的很深，这里就不展开了。感兴趣的读者可以参考《REST实战》。
这个API中所使用的表述格式应该是常见的通用格式
在RESTfulAPI中，对于资源的操作，是通过在服务器端-客户端之间传递资源的表述来间接完成的。资源的表述可以有很多种格式，并且在响应和请求中的资源表述格式也会有所不同。GET/POST响应中的资源表述格式，常见的有HTML、XML、JSON；POST/PUT请求中的资源表述格式，常见的有标准的HTML表单参数、XML、JSON。
4.这些常见表述格式，处理起来非常容易，有大量的框架和库提供支持。所以除非有很合理的要求，通常不需要使用自定义的私有格式。
使用HTTP响应状态代码来表达各种出错情况
HTTP响应状态代码，是HTTP协议这个统一接口中用来表达出错情况的标准机制。响应状态代码分成两部分：statuscode和reasonphase。两部分都是可定制的，也可以使用标准的statuscode，只定制reasonphase。
5.如果一个所谓的“RESTfulAPI”对于任何请求都返回200OK响应，在响应的消息体中返回出错情况信息，这种做法显然不符合“确保操作语义的可见性”这个REST架构风格的基本要求。
这个API应该对于HTTP缓存是友好的
6.充分利用好HTTP缓存是RESTfulAPI可伸缩性的根本。HTTP协议是一个分层的架构，从两端的useragent到originserver之间，可以插入很多中间组件。而在整个HTTP通信链条的很多位置，都可以设置缓存。HTTP协议内建有很好的缓存机制，可以分成过期模型和验证模型两套缓存机制。如果API设计者完全没有考虑过如何利用HTTP缓存，那么这个API的可伸缩性会有很多问题。
RESTful API设计中常见的问题和解决方案
在开发HTTP API的时候，我们一般会按照REST风格来设计，符合REST风格的API也称为RESTful API。
RESTful API的主要规则包括以下几点：
标准的RESTful API示例如下：
由于英语语法的特点和HTTP请求的方法数量的有限，可能存在一些无法覆盖到的部分，如下：
下面来谈谈上述未覆盖部分及其解决方案。
常规动作有GET,POST,PUT,PATCH和DELETE，也就是所谓的增删改查，但是现实中还有很多非前面提到的动作，如取消操作。
针对非常规动作，解决的方案有两种：
下面我们以取消订单为例，来看看针对该问题不同方案的实现。
该方案是GitHub在使用中的方案，在开放的API的可以看到。
针对实例的实现如下：
这个Google Could中Could API设计规范中定义的方案，语法为：
针对实例的实现如下：
该情况可按照英语语法使用对应的名词即可，如下:
使用可数名词来代替，如news可以用news-items来代替。
这种情况可以采用资源对应的名词的单数形式来表示获取一条数据, 该方案也适用于多对一的情况。
例如：用户的购物车数据，每个用户有一个购物车，可以表示如下：
怎样用通俗的语言解释什么叫 REST，以及什么是 RESTful
REST -- REpresentational State Transfer 直接翻译：表现层状态转移。这个中文直译经常出现在很多博客中。尼玛谁听得懂“表现层状态转移”？这是人话吗？我自己也困惑了很久，查询了很多资料，花了差不多一年有个还算清晰的理解。分享如下：
Ivony 老师的一句话概括很精辟：
URL定位资源，用HTTP动词（GET,POST,DELETE,DETC）描述操作。
--- 简洁版 ---
0. REST不是"rest"这个单词，而是几个单词缩写。但即使那几个单词说出来，也无法理解在说什么 -_-!! （不是要贬低人，是我自己也理解困难）；
1. REST描述的是在网络中client和server的一种交互形式；REST本身不实用，实用的是如何设计 RESTful API（REST风格的网络接口）；
2. Server提供的RESTful API中，URL中只使用名词来指定资源，原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。
REST和RESTFUL
REST（Representational State Transfer）,表述性状态转移，定义了互联网架构原则，是一种架构风格，具体原则如下：
1.互联网所有资源都可以被抽象为资源
2.每个资源都有唯一的资源标识符
3.同一个资源具有多个表现形式（可以是json,xml等等）
4.对资源的操作不会改变资源标识符
5.所有的操作都是无状态的
主要是就是说互联网上的资源可以用一种规则来表示，对资源的操作是无状态的。
RESTFUL,是指遵守rest规则的web服务，restful是一种ROA(Resource Oriented Architecture，面向资源的架构)，restful的核心概念就是资源（Resource）。
互联网中客户端和服务端的交互就是资源的表述，这种表述是无状态的，也就意味着服务端要报错资源的所有状态，客户端可以通过http协议按照规定的规则访问或者改变资源的状态，就是所谓的“表述性状态转移”。
具体表现形式如下：
GET /users 获取用户列表
GET /users/1 获取id（主键）为1的用户
POST /users 创建用户
PUT /users/1 修改id为1的用户（整条数据替换）
PATCH /users/1 修改id为1的用户（数据局部字段替换）
DELETE /users/1 删除id为1的用户
简单来说就是通过请求方法名来表示行为，url来表示操作的资源
更多例子：
GET /users/1/products 获取id为1用户下的产品列表
GET /users/1/products/1 获取id为1用户下的id为1的产品
GET /users/name/aaa/products 获取name为aaa的用户下的产品列表
GET /users/name/aaa/products/name/ppp 获取name为aaa的用户下的名为ppp的产品
POST /users/1/products id为1的用户下创建一个产品
PUT /users/1/products/1 修改id为1的用户下的id为1的产品（整条数据替换）
PATCH /users/1/products/1 修改id为1的用户下的id为1的产品（数据局部字段替换）
DELETE /users/1/products/1 修改id为1的用户下的id为1的产品
Restful协议
Representational State Transfer, 是一种软件架构风格，提供一系列限制指导，用于更好的创建 web service 。 符合REST 架构风格的web service 称为Restful web service。
其核心是以 资源 为关注点，而不是方法或消息, RESTful通常是用URL定位资源，HTTP动词（GET, POST, DELETE, PUT等) 描述对资源的操作，该操作过程即改变资源的表现形式，可使用JSON, XML等文件传递该资源操作信息。
Web端主要负责渲染和附带处理简单的商务逻辑，通过Restful API (JSON或其他格式，动词 + 名词)来传递数据和改变数据状态
简要对比下RPC & REST & SOA，不同的服务器向客户端提供服务的方法
SOAP和REST严格来说不是两个对等的概念，可理解为两种服务设计思想和及其具体的实现架构。
二者各有自己的使用场景。如果创建的分布式服务要求较好的安全性，对于传输等底层实现要求较强的可定制性，可以考虑SOAP；如果要求设计实现简单，一般来说安全性要求不高可以考虑REST。这只是一般情况，但偏于面向资源的服务使用REST有天然的优势。
SOAP在.NET中多使用WCF框架，而RESTful则多使用Web API。 具体可参考 Microsoft技术杂志文章
Restful 的好处，无需关注不同的Client等
什么是restful风格的api