从石器时代到田园牧歌：如何对 API 统一建模
API 作为系统间交互的契约，在软件工程领域有着非常关键的地位。随着互联网时代的兴起，各式各样的应用百花齐放，API 的形态也随着技术的演进有了非常大的变化。那么如何规范化地描述 API，使它适应技术与业务的飞速发展，就成为了一个极富挑战性的问题。
首先，本文将从 API 建模面临的问题入手，例如类型系统、架构风格，来使大家对该领域有一个初步的了解。在这个部分，我们可以看到 Swagger、APIBlueprint、APIDoc.js、GraphQL 等被广泛采用的方案，以及它们之间的对比。
