这在任何地方都很少被提及，但Richardson的成熟度模型是实际判断Restful是API的最佳方法之一。更多信息请点击此处：

理查德森成熟度模型

这是我对REST的基本概述。我试图演示RESTful架构中每个组件背后的思想，以便更直观地理解概念。希望这有助于为某些人揭开REST的神秘面纱！

REST（代表性状态转移）是一种设计架构，它概述了网络资源（即共享信息的节点）的设计和寻址方式。一般来说，RESTful体系结构使得客户端（请求机器）和服务器（响应机器）可以请求读取、写入和更新数据，而客户端不必知道服务器是如何操作的，并且服务器可以在不需要了解客户端的任何信息的情况下将数据传递回去。好吧，酷。。。但我们如何在实践中做到这一点？

最明显的要求是需要有某种通用语言，以便服务器可以告诉客户端它正在尝试如何处理请求，并让服务器做出响应。但是，要找到任何给定的资源，然后告诉客户该资源所在的位置，需要有一种指向资源的通用方法。这就是通用资源标识符（URI）的作用；它们基本上是查找资源的唯一地址。

但REST架构并没有就此结束！虽然以上内容满足了我们所需的基本需求，但我们也希望拥有一个支持高流量的体系结构，因为任何给定的服务器通常都会处理来自多个客户端的响应。因此，我们不想让服务器记住以前请求的信息，从而使服务器不堪重负。

因此，我们施加了一个限制，即客户端和服务器之间的每个请求-响应对都是独立的，这意味着服务器不必记住以前的请求（客户端-服务器交互的以前状态）来响应新请求。这意味着我们希望我们的交互是无状态的。为了进一步减轻我们的服务器因重做最近已为给定客户端完成的计算而承受的压力，REST还允许缓存。基本上，缓存意味着对提供给客户端的初始响应进行快照。如果客户端再次发出相同的请求，服务器可以向客户端提供快照，而不是重做创建初始响应所需的所有计算。但是，由于它是一个快照，如果快照尚未过期（服务器提前设置了过期时间），并且响应自初始缓存以来已更新（即请求将给出与缓存响应不同的答案），则客户端将不会看到更新，直到缓存过期（或缓存被清除），并且再次从头开始呈现响应。关于RESTful架构，最后一件事是它们是分层的。实际上，我们已经在讨论客户端和服务器之间的交互时隐式地讨论了这个需求。基本上，这意味着我们系统中的每个层只与相邻层交互。因此，在我们的讨论中，客户端层与服务器层交互（反之亦然），但可能有其他服务器层帮助主服务器处理客户端不直接通信的请求。相反，服务器根据需要传递请求。

现在，如果所有这些听起来都很熟悉，那就太好了。超文本传输协议（HTTP）定义了通过万维网的通信协议，它是RESTful架构抽象概念的一种实现（如果你像我一样是OOP狂热者，则是抽象REST类的实现）。在REST的这个实现中，客户端和服务器通过GET、POST、PUT、DELETE等进行交互，这些都是通用语言的一部分，可以使用URL指向资源。

Edit

阅读这里的自述文件，我希望你真的能得到REST。

https://github.com/lukepuplett/surfdude-csharp/blob/master/README.md

--

这些给出链接资源示例的答案很好，但只占一半。

所以，想象你正在设计一个网站。你写一个故事，

我希望能够通过邮政编码搜索地址，以便选择发货地址

然后，您将构建网站，让用户踏上旅程，并尝试在工作流中将页面链接在一起。

一个网站设计让他们进行地址查找，然后让他们将地址复制到剪贴板，然后返回到发货地址表单，这是不太有用的。

REST API使用我们在web上认为理所当然的模式进行机器-机器交互。

对邮政编码功能的搜索不应该是base/addresss/{postcode}，并且会返回一个集合，即使每个地址都链接到一个完整的地址和一些编辑链接，因为这是一个死胡同；API使用者需要猜测如何使用该地址。

相反，该功能的动机应内置于其使用的流程中，以便旅程在开始时结束：

1 GET /orders/123/shipping

  200 OK { Current shipping details + link to parent + link to address picker }

2  -> GET /orders/123/shipping/addresspicker

      200 OK { Link and form for searching for a postcode }

3   -> GET /orders/123/shipping/addresspicker?postcode=tn11tl

       200 OK { List of addresses each with link to pick it }

4    -> POST /orders/123/shipping/addresspicker?postcode=tn11tl&pickNo=3

        200 OK { Current shipping details + link to parent + link to address picker }

这是一次用户旅程，最后您可以看到流量对订单的影响。

HTTP请求/响应严格来说不是REST的一部分，但我认为没有人见过非HTTP REST应用程序。

现在这些URL可以是任何一组字符，它们只是标识符，我把它们做得很漂亮，因为它们对人们来说很有意义。机器将使用rel来计算它们做什么，而不依赖于可读的href。

我看到了一堆回答，说将用户123的所有内容放在资源“/user/123”是RESTful的。

罗伊·菲尔丁（Roy Fielding）创造了这个术语，他表示RESTAPI必须是超文本驱动的。特别是，“REST API不能定义固定的资源名称或层次结构”。

因此，如果您的“/user/123”路径在客户端上被硬编码，那么它就不是真正的RESTful。很好地使用HTTP，也许，也许不是。但不是RESTful。它必须来自超文本。

REST是一种分布式系统（如WWW）软件架构风格，您可以想象它是一个精心设计的Web应用程序规则：一组Internet网页（一个虚拟状态机），其中通过单击链接（状态转换）进行超链接，结果是下一个网页（这意味着应用程序的下一个状态）。

REST描述了网络系统由三部分组成：

数据元素（资源、资源标识符、表示）连接器（客户端、服务器、缓存、解析器、隧道）组件（源服务器、网关、代理、用户代理）

REST严格满足以下条件：

应用程序功能的状态被划分为资源用作超链接定位语法的每个资源（例如，在WWW URI中）所有资源在具有资源转换状态的客户端之间共享统一接口，包括：有限的一组定义良好的操作（如HTTPGET/POST/PUT/DELETE）一组有限的内容格式内容类型，可能包括可执行代码（例如，在WWW Javascript中）

为了在这里贡献一些新的东西，我想分享我文章中的链接，即通过一种实用和客观的方法将REST概念化。

我将介绍以下主要概念：

HATEOAS-超媒体作为应用程序状态的引擎，资源和表示，可寻址性，REST中的幂等性，Richardson的REST成熟度模型。媒体类型API版本控制

我还创建了一个GitHub项目，您可以使用docker轻松运行，它涵盖了我在本文中介绍的内容。

https://itnext.io/how-to-build-a-restful-api-a-deep-dive-into-rest-apis-215188f80854