一句话答案

RESTful 风格（GET 查/POST 增/PUT 改/DELETE 删）+ 统一响应格式 + 版本管理 + 幂等设计 + 限流保护。

核心要点

核心原则：

1. RESTful：GET查/POST增/PUT改/DELETE删
2. 统一响应：{code, message, data}
3. 版本控制：URL(/v1/)或Header
4. 幂等性：查询天然幂等，写操作需设计
5. 安全：鉴权/限流/参数校验/SQL注入防护

追问与易错

追问方向：

• 版本管理怎么做？
• 接口幂等怎么设计？
• 分页用 offset 还是 cursor？

易错点：

• ❌ 所有接口都用 POST——违反 RESTful
• ❌ 返回 200 就行——不同场景用不同状态码

💡 记忆锚点

好接口五要素口诀"动统版幂安"：动词语义化（GET查POST增PUT改DELETE删），统一响应格式（{code,message,data}），版本管理（/v1/打头），幂等设计（写操作防重复提交），安全防护（鉴权+限流+参数校验+防注入）。分页推荐游标cursor而非offset，深分页性能差。