19、探索五种API风格：选择与实现指南

探索五种API风格：选择与实现指南

1. API风格的重要性与一致性

API设计中，理想情况下，API的设计约束、风格选择和实现技术应保持一致。若不一致，可能导致设计不佳（设计约束与风格不匹配）或实现不佳（风格与技术不匹配）。本文介绍的五种API风格是基于API领域中流行的交互模式和技术挑选出来的，它们为理解众多API技术提供了有用的框架。每种风格的关键在于交互模型和主要抽象概念，且没有哪种风格绝对“更好”或“更差”，其适用性取决于具体的API设计任务约束。

2. 隧道风格（Tunnel Style）

• 起源与概念 ：隧道风格源于从IT角度考虑如何暴露现有功能，与远程过程调用（RPC）的思想相关，旨在让分布式系统感觉像本地系统。API为现有的“过程”（编程环境中调用命名代码单元的方式）而定义，成为本地编程中调用命名过程的简单扩展。
• 优点 ：从开发者角度看，创建API较为方便，因为主要抽象概念是过程，且很多过程已经存在。可以使用工具将过程暴露为API，很多“创建API”的任务可自动化，同时可使用API网关等组件来解决API安全管理问题。
• 结构 ：API由实现暴露，每个实现通常有一个“端点”，所有暴露的过程都作为API在此端点可用，所有过程调用都通过该端点“隧道传输”，这也是该风格名称的由来。若消费者使用不同实现中暴露的API，需使用各自的端点。
• 问题 ：“API端点”与实际暴露的API关联不大，只是所有调用必须通过的技术访问路径，这使得在网络层面