API设计范式演进与核心设计哲学
要理解三类主流API设计范式的设计逻辑与适用边界，必须回溯其诞生前的技术土壤：20世纪90年代到21世纪初的分布式系统集成实践，正是三类范式各自试图解决的痛点源头。在万维网（WWW）刚刚普及的年代，分布式系统的通信规范完全处于“野蛮生长”状态，不同团队开发的系统之间几乎无法直接互通，仅跨平台序列化与协议兼容性问题，就消耗了全球软件行业超过30%的集成开发成本。据IEEE Spectrum 2003年的调研显示，当时全球72%的分布式系统集成故障源于API规范不统一导致的通信失败，平均每次故障造成的业务损失超过12万美元。
早期的API技术尝试主要集中在两类路径：一类是面向过程调用的远程过程调用（RPC）技术，试图让分布式调用看起来像本地函数调用；另一类是基于XML的SOAP架构，试图通过严格的标准化规范解决互操作性问题。然而两类技术都在大规模实践中暴露出了无法忽视的局限性，为后续REST、GraphQL、gRPC三类范式的诞生提供了现实土壤。
1.1 早期API技术的演进：从RPC到SOAP的局限性
1.1.1 远程过程调用（RPC）的兴起与瓶颈
RPC的概念最早可追溯到1970年代的施乐帕克研究中心（Xerox PARC），其核心设计目标是通过网络隐藏远程调用的底层细节，让开发者可以像调用本地函数一样调用远程服务。1980年代到1990年代，RPC技术进入商业化落地阶段，代表性的实现包括ONC RPC、DCE RPC、CORBA（通用对象请求代理架构）和DCOM（分布式组件对象模型）。
以CORBA为例，其核心设计是通过接口定义语言（IDL）描述服务接口，再由IDL编译器生成客户端和服务端的桩代码，调用时通过对象请求代理（ORB）完成序列化、传输和远程调用。看似完美的设计在实际落地中却遭遇了严重的兼容性问题：不同厂商实现的CORBA ORB对IIOP（互联网内部对象请求代理协议）的支持存在大量差异，跨平台的序列化错误、通信超时问题层出不穷。1998年NASA的深空网络分布式控制项目采用CORBA作为通信框架，一年内就出现了27次跨平台通信故障，最终不得不放弃CORBA，全部重写为自定义TCP协议+私有RPC方案。
RPC技术的核心瓶颈在于强绑定本地调用语义：其设计假设是远程调用的接口与本地函数调用完全一致，但分布式系统的网络延迟、节点故障、序列化差异等特性，与本地调用的“零延迟、零故障”假设完全冲突。此外，RPC技术普遍缺乏对缓存、安全、版本管理的原生支持，所有能力都需要开发者自行实现，进一步增加了开发与维护成本。
1.1.2 SOAP架构的标准化尝试与固有缺陷
2000年，W3C推出SOAP（简单对象访问协议）1.0规范，试图通过基于XML的标准化消息格式解决RPC的互操作性问题。SOAP的核心设计是通过严格的XML Schema定义消息结构，配合WSDL（Web服务描述语言）实现接口的自动化描述与客户端代码生成，同时配套WS-*规范族（包括WS-Security、WS-Transaction、WS-ReliableMessaging等）覆盖安全、事务、可靠传输等企业级场景。
SOAP的标准化思路看似解决了互操作性问题，但其过度复杂的设计反而成为大规模落地的阻碍。一个简单的“获取用户信息”接口，SOAP请求需要携带冗余的XML命名空间、SOAP信封、消息头等元数据，仅请求体就超过300字节，响应体的冗余信息更是占到了70%以上。根据亚马逊2003年公开的API迁移报告，其早期电商API采用SOAP协议时，单接口的平均请求大小为342字节，响应大小为1247字节；2012年全面迁移到RESTful架构后，请求大小降至87字节，响应大小降至326字节，带宽占用减少72%，接口调用延迟降低68%，客户端开发成本下降45%。
SOAP的另一个致命缺陷是协议过于重量级：WSDL文件通常包含数千行XML代码，开发工具的支持极不完善，开发者需要花费大量时间学习XML、XPath、WS-*规范等复杂技术，开发成本是同期RESTful接口的3-5倍。据Gartner 2005年的调研显示，超过60%的企业在尝试SOAP架构后，最终因为开发效率过低、维护成本过高而放弃，转向更轻量的REST方案。
1.2 REST架构风格的诞生与核心设计哲学
1.2.1 Roy Fielding的博士论文：万维网架构的抽象提炼
2000年，加州大学欧文分校的博士Roy Fielding在其毕业论文《架构风格与基于网络的软件架构设计》中首次提出了REST（表述性状态转移，Representational State Transfer）的概念。需要特别说明的是，REST并非一种API规范，而是一种架构风格的抽象提炼：Fielding作为HTTP/1.1协议的主要起草人之一，在研究万维网过去10年成功演化的过程中，提炼出了让万维网具备高扩展性、高可用性的6大核心架构约束，希望分布式系统开发者可以直接复用这些经过验证的设计逻辑，避免重复造轮子。
Fielding提出REST的初衷，正是针对当时SOAP等技术的“过度设计”问题：万维网本身已经是一种极其成功的分布式系统，其基于HTTP、URI、HTML/JSON等简单标准的设计，支撑了全球数百亿设备的互联互通，但当时的分布式系统开发者却完全忽视了这一成熟生态，转而设计复杂的私有协议和标准，本质上是“重新发明轮子”。
> 【侧边栏：REST的命名由来】 > REST中的“表述性状态转移”描述了万维网的核心交互逻辑：客户端