cesium版本之间如何兼容_如何设计一个良好的 API

背景

现在软件开发流程都是协同合作的，前后端分离，那么我们如何实现对 API 的统一认知？又该如何设计一个良好的 API 接口？随着业务的演进，如何设计一个有兼容性的API？面对多种客户端，如何设计一个处处适用的 API 呢？

RESTful 是目前最流行的 API 设计规范，通过一定的规范可以解决上面这些问题，对于 RESTful 架构的理解可以参考阮一峰老师的这篇文章(http://www.ruanyifeng.com/blog/2011/09/restful.html)，简单一句话就是对服务器端资源进行操作，实现"表现层状态转化"。URI(统一资源定位符)代表一种资源，它可以是一段文本、一张图片、一首歌曲、一种服务；每种资源对应一个特定的 URI，存在着这种对应关系。

什么样的 API 是好的设计呢？

我们要遵循以下几个原则：

标准化

RESTful API 通过 GET POST PUT DELETE 等方式对服务器的资源进行操作，因此在定义 API 的时候需要明确定义出：请求方式、版本、资源名称和资源ID，格式如：GET http://{host}/{version}/{resources}/{resource_id}&#x