在构建 RESTful API 时，URI 的设计是至关重要的。一个好的 URI 风格设计能够提高 API 的可读性、可维护性和可扩展性。本文将介绍一些好的 URI 风格设计，并提供示例代码，帮助读者更好地理解和应用这些设计。
1. 使用名词而不是动词
RESTful API 的 URI 应该使用名词而不是动词来表示资源。这样可以使 URI 更加简洁和可读，同时也符合 HTTP 协议的语义。例如，使用 /users 来表示所有用户，而不是使用 /getUsers。
2. 使用复数形式
在 URI 中使用复数形式来表示资源，这样可以避免引起歧义。例如，使用 /users 来表示所有用户，而不是使用 /user。
3. 使用连字符而不是下划线
URI 中应该使用连字符而不是下划线来分隔单词，这样可以使 URI 更加易读和易懂。例如，使用 /user-profiles 来表示用户资料，而不是使用 /user_profiles。
4. 使用层次结构
URI 中使用层次结构可以更好地组织资源，使其更加易读和易懂。例如，使用 /users/{userId}/orders 来表示某个用户的订单列表。
5. 使用查询参数
在某些情况下，使用查询参数可以更好地表示某些资源。例如，使用 /users?role=admin 来表示所有管理员用户。
6. 使用 HTTP 动词
HTTP 协议定义了几种常用的动词，如 GET、POST、PUT、DELETE 等。在 RESTful API 中，应该使用这些动词来表示对资源的操作。例如，使用 GET 方法来获取资源，使用 POST 方法来创建资源，使用 PUT 方法来更新资源，使用 DELETE 方法来删除资源。
7. 使用 HTTP 状态码
HTTP 状态码可以用来表示 API 的响应状态。在 RESTful API 中，应该使用 HTTP 状态码来表示 API 的响应状态。例如，使用 200 状态码表示成功响应，使用 404 状态码表示资源未找到，使用 500 状态码表示服务器错误。
示例代码：
-- -------------------- ---- ------- - ------ --- ------ - ------ --- --------------- - ---- ---- ------ - ---- --- --------------- - ---- ------ --------------- - ----------- --- ---------------------- - --------- --- -----------------
总结
好的 URI 风格设计可以提高 RESTful API 的可读性、可维护性和可扩展性。在设计 RESTful API 的 URI 时，应该使用名词而不是动词，使用复数形式，使用连字符而不是下划线，使用层次结构，使用查询参数，使用 HTTP 动词和 HTTP 状态码。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/661516ccd10417a222564ed5