API 设计模式 (API Design Patterns)

设计一致且开发者友好的 REST API 的规范与最佳实践。

何时启用

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

资源设计 (Resource Design)

URL 结构