RESTful API 设计原则归纳总结
RESTful API 这个词,做后端的基本都听过。但说实话,很多人只是把它理解为「用 HTTP 方法操作数据」—— 说白了就是把数据库表直接暴露成接口。我早期也犯过这个错,直到被前端同事吐槽「你的接口怎么每个都长得不一样」,才回过头去啃 Roy Fielding 的那篇博士。
今天我不跟你扯理论,直接从实战角度,把 RESTful 最核心的设计原则拆开讲。你想想看,一个接口好不好用,其实就取决于这几条规则是否守住了。
从理论到实践:六大核心原则
REST 的架构约束一共有六条。别被「约束」这两个字吓到,它们不是来限制你的,而是帮你写出更干净的接口。我习惯把这六条分成两组来记:资源导向 和 统一接口 是骨架;无状态性、可缓存性、分层系统、按需代码 是血肉。下面这张图可以帮你快速建立整体认知——