API 设计模式

用于设计一致、对开发者友好的 REST API 的约定和最佳实践。

何时启用

• 设计新的 API 端点时
• 审查现有的 API 契约时
• 添加分页、过滤或排序功能时
• 为 API 实现错误处理时
• 规划 API 版本策略时
• 构建面向公众或合作伙伴的 API 时

资源设计

URL 结构