rest

REST 资源命名与错误结构统一实践(2025)

REST 资源命名与错误结构统一实践(2025)统一的资源命名与错误结构是 API 可用性的基础。一、资源命名名词复数:`/users`、`/orders`;避免动词化路径。层级关系:`/users/{id}/orders` 表示归属关系。过滤与排序:使用查询参数,如 `?status=active

REST分页:Link头与游标设计

在 REST 接口中使用 Link 头与游标实现稳定分页,统一前后向导航与兼容策略,提升可用性与性能。