REST API best practices

介绍Representational State Transfer (REST)是Roy Fielding于2000年在他的博士论文中定义的一种架构风格。REST描述了一种不特定于Web API的Web架构。然而，它已成为最流行的Web API风格，在2008年超过了SOAP。REST API使用简单、可扩展、可移植且易于集成。本白皮书的目的是了解创建RESTful API涉及哪些约束以及Web REST API的最佳实践是什么。

REST约束：

• 客户端-服务器： 客户端-服务器约束侧重于关注点分离。通过将前端UI与后端数据存储问题分开，提高了可移植性和可扩展性。这也允许单独的组件独立发展。

• 无国籍： 服务器不应存储当前会话的任何状态。这意味着从客户端发送到服务器的每个请求都必须包含完成请求所需的所有信息。

• 缓存： 客户端可以缓存响应，以减少与服务器的交互，提高性能。

• 统一接口： 为所有服务提供一个标准接口，使得服务的行为具有一致性。

• 分层系统： API可以设计成使用多个层次的结构，层次之间通过中间层进行隔离。

• 按需代码（可选）： 允许下载客户端所需的代码以扩展其功能。