京东到家开放平台网关系统设计实践-优快云博客

本文详细解读了京东到家开放平台的服务架构，包括服务设计规范、服务发布流程、服务授权机制，以及流量管控策略，特别介绍了固定窗口计数器在流量控制中的应用。

文｜王多友

编辑｜刘慧卿

一、平台介绍

京东到家开放平台，是一个面向商家以及第三方开发者的开放服务集成平台。平台提供了京东到家全业务场景系统对接的解决方案，商家开发者在自助接入开放平台时，平台会根据商家类型以及配送方式，自动适配出系统推荐的对接方案。为商家提供本地即时零售的能力，提高服务效率，降低运营成本。同时平台为消费者提供超市便利、生鲜果蔬、医药健康、烘焙蛋糕、鲜花绿植、家居时尚等海量商品1小时配送到家的极致服务体验。京东到家与多方业务合作伙伴一起协同，努力达成多快好省、降维增效的共赢愿景。

开放平台作为商家与到家内部服务交互桥梁，连接商家和到家内部服务。

二、服务设计

从技术层面来看，平台的核心是服务，如何运营好整个服务集群是我们的核心。从服务的生命周期来看，过程分为：定义->实施->迭代->下线，几个流程节点。

关于服务的定义，我面临的挑战有：

稳定性：开放平台服务是给商家使用的，服务的稳定性显得至关重要；

易用性：服务设计要简洁，请求参数要见名知意，针对错误码的定义需要非常明确，让调用者可以一眼就能看到问题的所在；

安全性：服务实施阶段平台对服务质量（监控粒度，安全授权）也有着严格要求；

扩展性：在服务的整个生命周期中，迭代方案如何做到可持续，也需要重点关注，比如是否支持平滑升级、是否支持无感知切换等；

从实现角度来看，开发者方便对接的核心是文档的定义，即约束平台的开发人员，又可以方便调用者快速理解。如何将文档给到对应商家开发者？最简单的方案就是编写一个离线文档，每当文档更新将最新的离线文档发给对应的商家开发者，这种做法简单但是后续会带来很大的沟通成本。比如每次文档更新后需要通知每个对接商家开发者并给予最新文档，前期对接商家较少还好，对接商家一旦过多，就会为开放平台带来很大交互成本。开放平台为了方便商家的对接，我们为商家提供了一套开放平台门户系统。

门户系统的存在可以为开发者和平台运营带来很大便捷。对于平台运营来说，新增、修改服务自动生成文档并以邮件和公告形式通知到开发者，减少与商家沟通成本，并且平台针对服务修改做到新老功能兼容。对于对接开发者来说，只需要关注需要字段即可，一旦服务发生变化并不影响正常调用，想要使用新功能参照最新文档即可。

服务列表文档