【微服务】Restfui API
【参考】
一文搞懂什么是RESTful API - 知乎 (zhihu.com)
【背景】
随着客户端种类的增加，为了解决跨平台问题，所有针对客户端与服务端之间通信的协议格式进行要求。
【概况】
RESTful是一种风格而不是标准，而这个风格大致有以下几个主要特征：
【作用】
【具体内容】
RESTful（Representational State Transfer）接口是一种基于HTTP协议设计的软件架构风格，用于创建可读的、可维护的、可扩展的Web服务。RESTful接口通常使用HTTP方法（如GET、POST、PUT、DELETE等）来操作资源，并通过URL来定位资源。
以下是RESTful接口的一些主要特点：
-
资源：RESTful API将一切都视为资源，每个资源都有一个唯一的URL。资源可以是用户、订单、产品等任何可以命名的事物。
-
HTTP方法：RESTful API使用HTTP协议中的方法（也称为“动词”）来执行对资源的操作。常用的HTTP方法有：
- GET：从服务器检索资源。
- POST：在服务器上创建新的资源。
- PUT：更新服务器上的资源。
- DELETE：从服务器上删除资源。
-
无状态：RESTful API是无状态的，即每个请求都必须包含理解该请求所必需的信息。服务器不会记住关于客户端的任何信息（如会话信息），因此可以很容易地扩展到大量的客户端。
-
URL设计：RESTful API的URL设计应该简洁明了，能够清晰地表达资源的层次结构和关系。例如，
/users/{userId}/orders/{orderId}可能表示一个特定用户的特定订单。 -
返回内容：RESTful API通常返回JSON或XML格式的数据。这些格式都是轻量级的，并且易于在不同的平台和语言之间解析。
-
错误处理：当请求失败时，RESTful API应该返回适当的HTTP状态码（如404表示未找到，500表示服务器内部错误等），并在响应体中提供有关错误的详细信息（如果可能）。
-
版本控制：随着API的发展，可能需要添加新功能或更改现有功能。RESTful API通常通过在URL中包含版本号（如
/v1/users）或使用HTTP头部（如Accept头部）来支持版本控制。 -
HATEOAS（Hypermedia as the Engine of Application State）：虽然这不是RESTful API的强制要求，但HATEOAS是一种使RESTful API更具发现性和自描述性的方法。通过在响应中包含指向其他资源的链接，客户端可以发现和执行额外的操作。
总之，RESTful接口是一种强大而灵活的方式来构建Web服务，它们可以轻松地与各种客户端（包括Web浏览器、移动应用、第三方服务等）进行交互。
