API 设计规范：一个后端应该知道的 RESTful 最佳实践

前言

作为一个后端开发者，你写的 API 可能被前端、移动端、第三方系统调用。一个好的 API 设计不只是"能跑就行"，它决定了团队协作效率、系统可维护性和调用方的开发体验。

我在职业生涯中见过太多"反模式"的 API 设计：URL 里全是动词、状态码永远 200、返回格式千奇百怪、命名毫无规范……这篇文章将系统性地梳理 RESTful API 设计的核心规范，让你写的每一个接口都经得起审视。

---

一、REST 核心原则

1.1 什么是 REST