这个答案是针对初学者的，让我们了解一下目前最常用的API架构。

了解Restful编程或Restful API。首先，您必须了解什么是API，在一个非常高级的API上，它代表应用程序编程接口，它基本上是一个软件，可以由另一个软件使用，以允许应用程序相互对话。

全球使用最广泛的API类型是web API，而每当有请求时，它都会向客户端发送数据。

事实上，API不仅用于发送数据，而且并不总是与web开发、javascript、python或任何编程语言或框架相关。

API中的应用程序实际上可以意味着许多不同的事情，只要软件的pice是相对独立的。以文件系统或HTTP模块为例，我们可以说它们是一小块软件，我们可以使用它们，我们可以通过使用它们的API与它们进行交互。例如，当我们对任何编程语言的文件系统模块使用read-file函数时，我们实际上使用的是file_system_reading API。或者，当我们在浏览器中进行DOM操作时，我们实际上并不是在使用JavaScript语言本身，而是在使用浏览器向我们公开的DOM API，因此它为我们提供了访问它的权限。或者，再举一个例子，让我们用Java等任何编程语言创建一个类，然后向其添加一些公共方法或财产，这些方法将成为从该类创建的每个对象的API，因为我们给其他软件提供了与我们的初始软件（在本例中为对象）交互的可能性。S0，API实际上具有比构建web API更广泛的含义。

现在让我们来看看构建API的REST体系结构。

REST（代表代表性状态转移）基本上是一种以逻辑方式构建web API的方式，使其易于为自己或他人使用。

要按照REST架构构建Restful API，我们只需要遵循几个原则。1.我们需要将API分成逻辑资源。2.然后应使用基于资源的URL公开这些资源。3.要对数据执行不同的操作，如读取、创建或删除数据，API应使用正确的HTTP方法，而不是URL。4.现在，我们实际发送回客户端或从客户端接收到的数据通常应该使用JSON数据格式，如果应用了某种格式标准。5.最后，EST API的另一个重要原则是它们必须是无状态的。

将API分离为逻辑资源：REST中信息的关键抽象是一种资源，因此，我们希望在API中共享的所有数据都应该划分为逻辑资源。什么是资源？好吧，在REST的上下文中，它是一个对象或某个事物的表示，它有一些与之相关的数据。例如，像导游、用户、地点或评论之类的应用程序就是逻辑资源的例子。因此，基本上任何可以命名的信息都可以是资源。不过，只需要命名，而不是动词。

暴露结构：现在我们需要暴露，这意味着使用一些结构化的URL来提供数据，客户端可以向其发送请求。例如，像这样的整个地址被称为URL。并且调用了这个/addNewTour和API端点。

我们的API将有许多不同的端点，如下所示

https://www.tourguide.com/addNewTour
https://www.tourguide.com/getTour
https://www.tourguide.com/updateTour
https://www.tourguide.com/deleteTour
https://www.tourguide.com/getRoursByUser
https://www.tourguide.com/deleteToursByUser

这些API中的每一个都会将不同的数据发送回客户端，并执行不同的操作。现在，这里的这些端点有一些非常错误的地方，因为它们确实没有遵循第三条规则，即我们应该只使用HTTP方法来对数据执行操作。因此，端点应该只包含我们的资源，而不是我们对其执行的操作，因为它们很快就会成为维护的噩梦。

我们应该如何在实践中使用这些HTTP方法？好了，让我们看看这些端点实际上应该是如何以/getTour开头的。所以这个getTour端点是为了获取关于一个旅游的数据，所以我们应该简单地命名这个端点/旅游，并在向这个端点发出get请求时发送数据。换句话说，当客户端使用GET HTTP方法访问端点时，

（我们只有端点或URL中的资源，没有动词，因为动词现在在HTTP方法中，对吗？通常的做法是总是使用复数形式的资源名称，这就是我写/tours或/tours的原因。）惯例是，当调用端点/游览时，将返回数据库中的所有游览，但如果我们只希望游览具有一个ID，比如说七个，我们会在另一个斜杠（/tours/7）或搜索查询（/tours？ID=7）中添加七个，当然，它也可以是游览的名称而不是ID。

HTTP方法：这里真正重要的是端点名称如何与所有端点名称完全相同。

GET: (for requesting data from the server.)

https://www.tourguide.com/tours/7
POST: (for sending data to the server.)
https://www.tourguide.com/tours
PUT/PATCH: (for updating requests for data to the server.) https://www.tourguide.com/tours/7
DELETE: (for deleting request for data to the server.)
https://www.tourguide.com/tours/7

PUT和PATCH之间的差异->通过使用PUT，客户端应该发送整个更新的对象，而使用PATCH，客户端应该只发送已更改的部分对象。

通过使用HTTP方法，用户可以执行基本的四个CRUD操作，CRUD代表创建、读取、更新和删除。

现在可能会出现如下情况：

因此，/getToursByUser可以简单地转换为/users/tours，对于第3号用户，终点将类似/users/3/tours。

如果我们想删除特定用户的特定游览，那么URL应该是/users/3/tours/7，这里是用户id:3和游览id:7。

因此，像这样整合资源的可能性真的很多。

以JSON形式发送数据：现在，关于客户端实际接收到的数据，或者服务器从客户端接收到的，我们通常使用JSON数据格式。典型的JSON可能如下所示：在发送JSON数据之前，我们通常会进行一些简单的响应格式化，这有几个标准，但其中一个非常简单的标准叫做Jsend。我们只需创建一个新对象，然后向其添加一条状态消息，以通知客户端请求是成功、失败还是错误。然后我们将原始数据放入一个名为data的新对象中。

像我们在这里所做的那样，将数据包装到一个额外的对象中称为包络，这是缓解一些安全问题和其他问题的常见做法。

Restful API应该始终是无状态的：最后，Restful API应该总是无状态的，这意味着，在无状态的Restful API中，所有状态都在客户端处理，而不是在服务器上。状态只是指应用程序中可能随时间变化的一段数据。例如，某个用户是登录的还是在一个包含多个页面的列表的页面上，当前页面是什么？现在，状态应该在客户端上处理这一事实意味着每个请求都必须包含在服务器上处理特定请求所需的所有信息。因此，为了处理当前请求，服务器永远不必记住以前的请求。

让我们假设目前我们在第五页，我们想前进到第六页。因此，我们可以有一个名为/tours/nextPage的简单端点，并向服务器提交一个请求，但服务器必须确定当前页面是什么，并根据该页面将下一个页面发送给客户端。换句话说，服务器必须记住先前的请求。这正是我们希望在RESTful API中避免的。

我们应该创建一个/tours/page端点，而不是这种情况并将数字6粘贴到其上，以请求第6页/游览/第6页。所以服务器不必记住其中的任何内容，它所要做的就是按照我们的要求发回第六页的数据。

无状态和无状态是计算机科学和一般应用中非常重要的概念

一种称为REST（RepresentationalStateTransfer）的体系结构风格主张web应用程序应该像最初设想的那样使用HTTP。查找应使用GET请求。PUT、POST和DELETE请求应分别用于变异、创建和删除。

REST支持者倾向于使用URL，例如

http://myserver.com/catalog/item/1729

但REST架构不需要这些“漂亮的URL”。带有参数的GET请求

http://myserver.com/catalog?item=1729

完全是RESTful的。

请记住，GET请求不应用于更新信息。例如，向购物车添加项目的GET请求

http://myserver.com/addToCart?cart=314159&item=1729

这是不合适的。GET请求应该是幂等的。也就是说，发出两次请求与发出一次请求应该没有区别。这就是请求可缓存的原因。一个“添加到购物车”请求不是幂等的，发出两次请求会向购物车添加两个项目副本。POST请求显然适合于这种情况。因此，即使是RESTful web应用程序也需要共享POST请求。

这摘自大卫·M·Geary的优秀著作《核心JavaServer面孔》。

RESTAPI是一种遵循REST体系结构约束的API实现。它充当一个接口。客户端和服务器之间的通信通过HTTP进行。RESTAPI利用HTTP方法建立客户端和服务器之间的通信。REST还使服务器能够缓存响应，从而提高应用程序的性能。客户端和服务器之间的通信是一个无状态的过程。我的意思是，客户端和服务器之间的每一次通信都像一次新的通信。

没有从以前的通信中携带的信息或记忆。因此，每次客户端与后端交互时，它都必须向其发送身份验证信息。这使后端能够确定客户端是否有权访问数据。

通过REST API的实现，客户端可以获得要与之通信的后端端点。这完全分离了后端和客户端代码。

如果我没有直接回答这个问题，我很抱歉，但通过更详细的例子更容易理解这一切。由于所有的抽象和术语，字段化并不容易理解。

这里有一个很好的例子：

解释REST和超文本：垃圾邮件清理机器人Spam-E

更棒的是，这里有一个简单的例子（powerpoint更全面，但你可以在html版本中获得大部分内容）：

http://www.xfront.com/REST.ppt或http://www.xfront.com/REST.html

看完这些例子后，我明白了Ken为什么说REST是超文本驱动的。但我实际上并不确定他是对的，因为/user/123是指向资源的URI，我不清楚它是否是非RESTful的，因为客户端知道它是“带外”的

xfront文档解释了REST和SOAP之间的区别，这也非常有用。当Fielding说：“这是RPC。它尖叫RPC。”时，很明显RPC不是RESTful的，所以了解这一点的确切原因很有用。（SOAP是RPC的一种类型。）

什么是REST？REST代表代表性状态转移。（有时拼写为“ReST”。）它依赖于无状态的、可缓存的客户端服务器通信协议——实际上在所有情况下，都是HTTP使用协议。REST是一种用于设计网络应用程序的架构风格。其思想是，使用RPC或SOAP连接机器，使用简单的HTTP机器之间的呼叫。在许多方面，可以查看基于HTTP的万维网本身作为基于REST的架构。RESTful应用程序使用HTTP请求发布数据（创建和/或更新）、读取数据（例如，并删除数据。因此，REST对所有四个CRUD使用HTTP（创建/读取/更新/删除）操作。REST是RPC（远程过程调用）和Web服务（SOAP、WSDL等）看看REST有多简单。尽管REST很简单，但它功能齐全；基本上有在Web服务中，没有什么是RESTful无法完成的建筑学REST不是“标准”。永远不会有W3C例如REST推荐。尽管有REST编程框架，使用REST非常简单通常使用诸如Perl、Java或C#。

当我试图找到休息的简单真正含义时，我找到了最好的参考之一。

http://rest.elkstein.org/

我认为restful的要点是将状态分离到更高的层，同时将互联网（协议）用作无状态传输层。大多数其他方法都会混淆。

这是处理互联网时代编程的根本变化的最佳实用方法。关于根本性的变化，Erik Meijer在这里就表演进行了讨论：http://www.infoq.com/interviews/erik-meijer-programming-language-design-effects-purity#view_93197 . 他将其概括为五种效果，并通过将解决方案设计成编程语言来提出解决方案。该解决方案也可以在平台或系统级别实现，无论使用何种语言。restful可以被视为在当前实践中非常成功的解决方案之一。

使用restful风格，您可以在不可靠的互联网上获取和操纵应用程序的状态。如果当前操作无法获得正确的当前状态，则需要零验证原则来帮助应用程序继续。如果它无法操纵状态，它通常使用多个确认阶段来保持正确。从这个意义上讲，rest本身并不是一个完整的解决方案，它需要web应用程序堆栈的其他部分中的功能来支持其工作。

鉴于这个观点，rest风格并没有真正与互联网或web应用程序绑定。这是许多编程情况的基本解决方案。它也不简单，它只是让界面变得非常简单，并且可以很好地处理其他技术。

只有我的2厘米。

编辑：两个更重要的方面：

无国籍是一种误导。它与restful API有关，而不是应用程序或系统。系统需要有状态。Restful设计是基于无状态API设计有状态系统。另一位QA的一些引用：REST对资源表示进行操作，每个资源表示由URL标识。这些通常不是数据对象，而是复杂的对象抽象。REST代表“代表性状态转移”，这意味着它是关于通信和修改系统中某些资源的状态的。幂等性：REST中一个经常被忽视的部分是大多数动词的幂等性。这导致了健壮的系统和语义精确解释之间的相互依赖性降低。