接口设计的最佳实践与关注点
哪些公司问过
答案要点
- RESTful 风格:以资源为中心设计 URL,用 HTTP 方法表达操作,正确使用状态码
- 对使用者友好:命名一致、参数少、提供默认值,统一分页和排序约定
- 统一响应结构和错误码规范,错误信息能帮助调用方定位问题
- 写接口保证幂等,支持安全重试;做好鉴权、参数校验、限流
- 版本管理与向后兼容,配套文档和示例
易错点
- 所有接口都返回 HTTP 200,错误只放在业务码里,调用方和监控难以区分
- 用 GET 执行删除或修改等有副作用的操作
- 直接修改已有字段含义或类型,破坏向后兼容
面试官常见追问
- 接口幂等怎么实现?
- 接口鉴权有哪些方式?
- 接口升级如何不影响老调用方?
完整的口述示范答案、每个追问的参考回答,在启面刷题中心查看;也可以让 AI 面试官用语音按这道题连环追问你。