RESTful API 设计规范：路由、状态码、分页与错误处理

资源化路由：名词复数（/api/v1/users），HTTP 方法语义（GET 查、POST 建、PUT 全量改、PATCH 部分改、DELETE 删）；状态码：200/201/204、400（参数错）、401（未认证）、403（无权限）、404、409（冲突）、500。统一响应结构：{code, message, data} 或直接 REST 资源 + 错误 JSON。最佳实践：版本化 /api/v1、分页（page/page_size）、排序过滤参数、幂等设计（PUT）、错误信息不泄露内部细节、HATEOAS 可选。