创作者 | Tanmay Deshpande

译员 | 明知道山

方案策划 | 丁晓昀

近期，LinkedIn 提及了她们怎样为 LinkedIn Marketing API 搭建 API 版本化架构，容许外界合作伙伴依照自己的节奏迁移到新版本的 API。

在这个新架构中，每一个 API 产品都是通过一个为外界合作伙伴给予 API 的中间层公布其版本变的实体模型和 API。中间层 API 和实体模型根据特定版本向外界公开化，用户可依照自己的节奏迁移到新版本。

遗留的构架由各种各样业务线搭建的后面 API 构成，并且通过 Rest.liAPI 网关对外开放公布。由于这类 API 并没有版本操纵，全部为内部结构 API 完成的东西就就会直接曝露给外面客户。

本文解释说：“未版本变的 API 限制了客户浏览最新特性，并为内部结构开发特性增添了考验。除此之外，开发人员的报告表示，大家在短期内公布了很多很多 API 变动，打乱了他的方案。”

LinkedIn 打造了一个新的架构，根据特殊版本公布实体模型和 API 变动，进而高效地将外界应用软件的变动隔离，并容许合作伙伴依照自己的节奏迁移到新版本。

每每外界应用软件请求特定 API 版本时，API 网关并对请求开展变换，并把它分享到适度的中间层。

与其它 API 网关一样，这一构架里的 API 网关含有身份认证、请求投射、节流阀操纵、受权、反乱用控制与请求生产调度作用。

最后，中间层将后端达到的特性公布给外界应用软件。

每一个 API 商品只有一个中间层。

同一逻辑性网络资源的差异版本还可以在中间层中并存，并且在编码中维护保养这一引入。网关应用请求投射启用所需要的网络资源版本。

中间层服务承担从业务线启用后面与版本不相干的服务项目。假如中间层服务项目在编码中维护保养特殊于版本的思路，则可能会致使代码维护难题。为了防止这样的事情，团队构建了“版本实行架构”库，用以进行两件重要的事——根据客户界定的变换将请求转换成最新很有可能版本；请求被转换成最新很有可能版本后，会再次根据客户界定内部的实体模型转化器把它转换成全新可利用的内部结构实体模型。

这一完成体现出了 LinkedIn“不影响顾客”的设计原理。

伴随着版本变的 LinkedIn Marketing API 于 2022 年 6 月公布，开发人员和合作伙伴可以用这种相对稳定的 API。

https://www.infoq.com/news/2022/08/linkedin-api-versioning/