设计优雅、规范的 API 接口,能极大降低前后端沟通成本和维护难度。
1. URL 设计规范
- 名词复数: 资源通常用复数表示。
GET /users: 获取用户列表GET /users/1: 获取 ID 为 1 的用户
- 层级结构: 体现资源关系。
GET /users/1/orders: 获取用户 1 的订单列表
设计优雅、规范的 API 接口,能极大降低前后端沟通成本和维护难度。
GET /users: 获取用户列表GET /users/1: 获取 ID 为 1 的用户GET /users/1/orders: 获取用户 1 的订单列表