03-03 REST 与 GraphQL:两种接口点菜方式

03-03 REST与GraphQL 是两种常见 API 风格。REST 像按菜单点固定菜,GraphQL 像告诉厨房你只要哪些食材。


一、它解决什么

它解决的是客户端如何向服务端表达数据需求。REST 简单清晰,GraphQL 灵活但治理要求更高。

二、一个比喻

REST 像“来一份套餐 A”;GraphQL 像“套餐里我只要米饭、鸡肉和青菜,不要汤”。

三、放到系统里看

REST 常用 URL 和 HTTP 方法表达资源操作;GraphQL 常用一个入口,由客户端声明要哪些字段。

四、常见坑 / 学习抓手

常见坑是为了潮流选 GraphQL,却没有权限、缓存、复杂度控制。小系统 REST 往往更简单。

一句话总结

REST 重在资源和约定,GraphQL 重在灵活查询。


关联笔记