1. 用名词表示资源，动词交给 HTTP 方法
2. 状态码要准确
3. 分页、排序、筛选参数统一风格
4. 错误响应结构固定
5. 版本号放在路径里

接口稳定比好看更重要。