2023年8月1日发(作者：)

什么是RESTAPI？REST指⼀组架构约束条件和原则，满⾜约束条件和原则的应⽤程序设计。架构，软件体系结构分为三部分：构建，⽤于描述计算机；连接器，⽤于描述构建的链接部分；配置将构建和连接器组成有机整体。web基本技术：URI（统⼀资源标⽰符）HTTP（超⽂本传输协议）（post、get、put、delete）Hypertext。1、每个资源都应该有唯⼀的⼀个标识2、使⽤标准的⽅法更改资源的状态3、request和response的⾃描述4、资源多重表述5、⽆状态服务

Rest API 开发 学习笔记 概述REST 从资源的⾓度来观察整个⽹络，分布在各处的资源由URI确定，⽽客户端的应⽤通过URI来获取资源的表⽰⽅式。获得这些表徵致使这些应⽤程序转变了其状态。随着不断获取资源的表⽰⽅式，客户端应⽤不断地在转变着其状态，所谓表述性状态转移（RepresentationalState Transfer）。这⼀观点不是凭空臆造的，⽽是通过观察当前Web互联⽹的运作⽅式⽽抽象出来的。Roy Fielding 认为，“设计良好的⽹络应⽤表现为⼀系列的⽹页，这些⽹页可以看作的虚拟的状态机，⽤户选择这些链接导致下⼀⽹页传输到⽤户端展现给使⽤的⼈，⽽这正代表了状态的转变。”REST是设计风格⽽不是标准。REST通常基于使⽤HTTP，URI，和XML以及HTML这些现有的⼴泛流⾏的协议和标准。资源是由URI来指定。

对资源的操作包括获取、创建、修改和删除资源，这些操作正好对应HTTP协议提供的GET、POST、PUT和DELETE⽅法。

通过操作资源的表现形式来操作资源。

资源的表现形式则是XML或者HTML，取决于读者是机器还是⼈，是消费的客户软件还是。当然也可以是任何其他的格式。

REST的要求客户端和服务器结构

连接协议具有⽆状态性

能够利⽤Cache机制增进性能

层次化的系统

随需代码 - Javascript （可选）

RESTful Web 服务RESTful Web 服务（也称为 RESTful Web API）是⼀个使⽤HTTP并遵循REST原则的。它从以下三个⽅⾯资源进⾏定义：URI，⽐如：。§ 接受与返回的互联⽹媒体类型，⽐如：JSON，XML ，YAML 等。§ Web服务在该资源上所⽀持的⼀系列请求⽅法（⽐如：POST，GET，PUT或DELETE）。该表列出了在实现RESTful Web 服务时⽅法的典型⽤途。

HTTP 请求⽅法在RESTful Web 服务中的典型应⽤

资源GETPUTPOSTDELETE⼀组资源的URI，⽐如列出 URI，以及该资源组中每个资源的详细信息（后者可选）。使⽤给定的⼀组资源替换当前整组资源。在本组资源中创建/追加⼀个新的资源。 该操作往往返回新资源的URL。删除 整组资源。单个资源的URI，⽐如142获取 指定的资源的详细信息，格式可以⾃选⼀个合适的⽹络媒体类型（⽐如：XML、JSON等）替换/创建 指定的资源。并将其追加到相应的资源组中。把指定的资源当做⼀个资源组，并在其下创建/追加⼀个新的元素，使其⾪属于当前资源。删除 指定的元素。PUT 和 DELETE ⽅法是幂等⽅法。GET⽅法是安全⽅法 （不会对有修改，因此也是幂等的）。不像基于SOAP的Web服务，RESTful Web服务并没有的“正式”标准。 这是因为REST是⼀种架构，⽽SOAP只是⼀个协议。虽然REST不是⼀个标准，但在实现RESTful Web服务时可以使⽤其他各种标准（⽐如HTTP，URL，XML，PNG等）。REST的优点可以利⽤缓存Cache来提⾼通讯本⾝的⽆状态性可以让不同的服务器的处理⼀系列请求中的不同请求，提⾼服务器的扩展性

浏览器即可作为客户端，简化软件需求

相对于其他叠加在HTTP协议之上的机制，REST的软件依赖性更⼩

不需要额外的资源发现机制

在软件技术演进中的长期的兼容性更好

2023年8月1日发(作者：)

什么是RESTAPI？REST指⼀组架构约束条件和原则，满⾜约束条件和原则的应⽤程序设计。架构，软件体系结构分为三部分：构建，⽤于描述计算机；连接器，⽤于描述构建的链接部分；配置将构建和连接器组成有机整体。web基本技术：URI（统⼀资源标⽰符）HTTP（超⽂本传输协议）（post、get、put、delete）Hypertext。1、每个资源都应该有唯⼀的⼀个标识2、使⽤标准的⽅法更改资源的状态3、request和response的⾃描述4、资源多重表述5、⽆状态服务

Rest API 开发 学习笔记 概述REST 从资源的⾓度来观察整个⽹络，分布在各处的资源由URI确定，⽽客户端的应⽤通过URI来获取资源的表⽰⽅式。获得这些表徵致使这些应⽤程序转变了其状态。随着不断获取资源的表⽰⽅式，客户端应⽤不断地在转变着其状态，所谓表述性状态转移（RepresentationalState Transfer）。这⼀观点不是凭空臆造的，⽽是通过观察当前Web互联⽹的运作⽅式⽽抽象出来的。Roy Fielding 认为，“设计良好的⽹络应⽤表现为⼀系列的⽹页，这些⽹页可以看作的虚拟的状态机，⽤户选择这些链接导致下⼀⽹页传输到⽤户端展现给使⽤的⼈，⽽这正代表了状态的转变。”REST是设计风格⽽不是标准。REST通常基于使⽤HTTP，URI，和XML以及HTML这些现有的⼴泛流⾏的协议和标准。资源是由URI来指定。

对资源的操作包括获取、创建、修改和删除资源，这些操作正好对应HTTP协议提供的GET、POST、PUT和DELETE⽅法。

通过操作资源的表现形式来操作资源。

资源的表现形式则是XML或者HTML，取决于读者是机器还是⼈，是消费的客户软件还是。当然也可以是任何其他的格式。

REST的要求客户端和服务器结构

连接协议具有⽆状态性

能够利⽤Cache机制增进性能

层次化的系统

随需代码 - Javascript （可选）

RESTful Web 服务RESTful Web 服务（也称为 RESTful Web API）是⼀个使⽤HTTP并遵循REST原则的。它从以下三个⽅⾯资源进⾏定义：URI，⽐如：。§ 接受与返回的互联⽹媒体类型，⽐如：JSON，XML ，YAML 等。§ Web服务在该资源上所⽀持的⼀系列请求⽅法（⽐如：POST，GET，PUT或DELETE）。该表列出了在实现RESTful Web 服务时⽅法的典型⽤途。

HTTP 请求⽅法在RESTful Web 服务中的典型应⽤

资源GETPUTPOSTDELETE⼀组资源的URI，⽐如列出 URI，以及该资源组中每个资源的详细信息（后者可选）。使⽤给定的⼀组资源替换当前整组资源。在本组资源中创建/追加⼀个新的资源。 该操作往往返回新资源的URL。删除 整组资源。单个资源的URI，⽐如142获取 指定的资源的详细信息，格式可以⾃选⼀个合适的⽹络媒体类型（⽐如：XML、JSON等）替换/创建 指定的资源。并将其追加到相应的资源组中。把指定的资源当做⼀个资源组，并在其下创建/追加⼀个新的元素，使其⾪属于当前资源。删除 指定的元素。PUT 和 DELETE ⽅法是幂等⽅法。GET⽅法是安全⽅法 （不会对有修改，因此也是幂等的）。不像基于SOAP的Web服务，RESTful Web服务并没有的“正式”标准。 这是因为REST是⼀种架构，⽽SOAP只是⼀个协议。虽然REST不是⼀个标准，但在实现RESTful Web服务时可以使⽤其他各种标准（⽐如HTTP，URL，XML，PNG等）。REST的优点可以利⽤缓存Cache来提⾼通讯本⾝的⽆状态性可以让不同的服务器的处理⼀系列请求中的不同请求，提⾼服务器的扩展性

浏览器即可作为客户端，简化软件需求

相对于其他叠加在HTTP协议之上的机制，REST的软件依赖性更⼩

不需要额外的资源发现机制

在软件技术演进中的长期的兼容性更好