Swagger

好的 API 设计让前后端协作效率翻倍。从 URL 命名到状态码选择，从版本管理到文档生成，一套可落地的规范。 一、RESTful 的核心原则 1.1 资源导向——URL 是名词而非动词 1.2 HTTP 方法语义——GET / POST / PUT / DELETE / PATCH 1.3 状态码的正确使用 1.4 无状态——每个请求包含全部信息 二、URL 命名规范 2.1 复数形式——/users 而非 /user 2.2 层级关系——/users/{id}/orders 2.3 避免深层嵌套——最多 3 层 2.4 使用短线分隔——/...