编辑“RESTful API”（章节）

== 设计原则 ==
1、资源定位：使用URI（统一资源标识符）来标识资源，通常采用名词来表示资源，如/users表示用户资源集合。

2、直观简洁：接口应该直观且简洁，风格命名保持一致，使得API易于理解和使用。

3、版本化：为了支持上层[[UI]]的灵活性，API必须进行版本化管理，以便于后续的更新和迭代。

4、HTTP方法操作资源：通过HTTP方法如[[GET]]、POST、PUT、DELETE等来操作资源，每种方法对应资源的CRUD（创建、读取、更新、删除）操作。

5、状态码表示结果：使用HTTP状态码来表示操作的结果，如200系列表示成功，400系列表示客户端错误，500系列表示服务器错误。

6、内容协商：支持返回不同的数据格式，通常是[[JSON]]或[[XML]]，这取决于客户端的接受能力和需求。

7、统一接口：确保接口的设计遵循一致性原则，减少不必要的复杂性和学习成本。

8、资源标识：每个资源都应该有一个唯一的URI，便于定位和操作。

9、客户端-服务器分离：客户端和服务器应该是解耦的，服务器不保存客户端的任何状态，每次请求都应包含所有必要的信息。

10、无状态通信：虽然服务器不保存客户端状态，但可以通过诸如[[Cookies]]和[[Session]]等机制在服务器端保持会话状态。