RESTful（代表性状态转移）API编程是通过以下5个基本的软件架构风格原则，以任何编程语言编写web应用程序：

资源（数据、信息）。唯一的全局标识符（所有资源都由URI标识）。统一接口-使用简单标准接口（HTTP）。表示-所有通信都是通过表示（例如XML/JSON）完成的无状态（每个请求都是在完全隔离的情况下发生的，这样更容易缓存和负载平衡），

换句话说，您正在通过HTTP编写简单的点对点网络应用程序，该应用程序通过实现RESTful架构使用GET、POST、PUT或DELETE等动词，该架构提出了每个“资源”公开的接口的标准化。以一种简单有效的方式（高度成功、经过验证和分布式架构）使用web的当前特性并不重要。它是SOAP、CORBA和RPC等更复杂机制的替代方案。

RESTful编程符合Web体系结构设计，如果实现得当，它允许您充分利用可扩展的Web基础设施。

一种称为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面孔》。

这就是它可能看起来的样子。

创建具有三个财产的用户：

POST /user
fname=John&lname=Doe&age=25

服务器响应：

200 OK
Location: /user/123

以后，您可以检索用户信息：

GET /user/123

服务器响应：

200 OK
<fname>John</fname><lname>Doe</lname><age>25</age>

要修改记录（姓名和年龄将保持不变）：

PATCH /user/123
fname=Johnny

要更新记录（因此lname和age将为NULL）：

PUT /user/123
fname=Johnny

我看到了一堆回答，说将用户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中）

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

理查德森成熟度模型