RESTful API 设计：让前端开发者爱上你的接口

好的 API 设计让前后端协作顺畅，糟糕的 API 让人崩溃。

资源命名：

• ✅ /users/123 - 名词，复数
• ❌ /getUsers - 动词，不应该出现

HTTP 方法语义：

• GET - 获取资源
• POST - 创建资源
• PUT - 更新资源（全量）
• PATCH - 更新资源（部分）
• DELETE - 删除资源

状态码使用：

• 200 - 成功
• 201 - 创建成功
• 400 - 请求错误
• 401 - 未授权
• 404 - 资源不存在
• 500 - 服务器错误

响应格式统一：

{
  "code": 0,
  "message": "success",
  "data": {}
}

版本控制： /api/v1/users