书籍推荐:《API 设计模式》


为任何领域、技术或平台设计可演变的高质量API的成熟模式

本书提供了理论和实践的健康组合,包含了许多深刻的建议,但从未失去大局观......以现实世界的经验为基础,以学术的严谨性和实践者社区的反馈为基础进行记录。我相信,[它]将为社区提供良好的服务,无论是今天还是明天。

--斯图加特大学应用系统结构研究所常务副所长Frank Leymann博士。

API在各类组织和生态系统中实现了突破性创新和数字化转型。为了创建用户友好、可靠和性能良好的API,架构师、设计师和开发人员需要专家的设计指导。这本实用指南突破了API对话及其信息内容的复杂性,介绍了全面的准则和启发式方法,以可持续地设计API,并明确规定它们,无论你使用什么技术或平台。

在《API设计的模式》中。简化松散耦合消息交换的集成,五位专家架构师和开发人员涵盖了整个API生命周期,从启动项目和建立目标到定义需求、阐述设计、规划演变和创建有用的文档。他们将许多从业者的集体知识结晶为44种API设计模式,并以背景、利弊、概念性解决方案和具体实例进行了一致的解释。为了使他们的模式语言易于理解,他们提出了一个领域模型、一个运行中的案例研究、带有模式选择选项和标准的决策叙述,以及在两个不同行业应用模式的真实世界项目的演练。

  • 用模式识别并克服API设计的挑战
  • 充分确定你的端点类型和操作的大小
  • 设计请求和响应信息以及它们的表现形式
  • 完善你的消息设计以保证质量
  • 计划发展你的API
  • 记录和交流你的API合同
  • 结合模式来解决现实世界的问题并做出正确的权衡