理解电商平台&商家：开放平台API接口

对于电商平台来说，一般会经历从自营到平台的过程，在这个过程中，需要快速扩充规模，就需要自动化处理，这时候就需要“开放平台”。主要把网站的服务封装成数据接口开放出去，供第三方开发者使用。Open API在互联网企业中应用比较广泛，是连接内部系统和外部系统的必要方案。

对于电商平台来说，发展到一定阶段，开放平台是必不可少的一部分。电商的开放平台主要是开放两方面的能力：销售体系和推广分佣体系。

销售体系一般是开放给平台商家使用，主要包括商品、订单、营销等方面，商家通过对接开放平台，可以快速管理商品、订单、营销。除了商家，ERP等软件服务商对接开放平台后，也可以提供给ERP上的中小商家管理多电商平台。

电商平台发展到一定阶段，除了通过内部流量，一般要拓展外部流量。例如淘宝的淘宝客、拼多多的多多客，第三方推广方可以通过开放平台接入推广体系，获得相应返利，开放推广分佣体系。

既然“开放平台”对于电商如此重要，那如何设计开放平台呢？以下是我从产品的角度来思考开放平台的设计，欢迎技术同学一起讨论。

? 1??? 开放平台框架? ? ?

现在你想让第三方接入你们平台，你得思考几个问题：

• 哪些用户可以接入？

• 如何对他们的身份进行识别？

• 哪些业务可以通过API接口接入解决？

• 性能可以支持多少并发？

考虑清楚这些问题，我们就可以开始着手设计开放平台。一般开放平台分为系统层和应用层，系统层是解决双方对接的问题，应用层是解决业务的问题。

如图所示，开放平台的系统层包括用户管理、用户鉴权、API监控、测试等四方面。

• 用户管理：管理对接的第三方用户，定义每个用户的权限，开通appkey、AppSecret以及流量上限。

• 用户鉴权：第三方调用接口时，对用户权限进行鉴权，保证数据安全。

• API监控：监控每个用户调用API的情况，发现异常及时预警，自动处理。

• 测试：提供给第三方进行测试的工具，例如在线测试 。

处理好这四方面，基本解决了系统层的主要问题。

应用层主要是处理具体业务，对于电商的开放平台，核心业务包括商品、订单、营销、用户、店铺等方面，通过这些业务API，第三方可以快速对接业务，不用在平台的后台手工操作。

值得提起的是，大一点的电商平台都有自己的服务平台，ISV服务商可以通过对接开放平台来给平台上的商家提供服务，也可以把平台能力进行释放，让更多企业能够参与到生态建设中。例如淘宝服务市场，ISV服务商通过淘宝开放平台提供的接口开发各种服务商家的工具，在淘宝服务市场进行售卖。

? ?2??? ?对接流程? ??

对接开放平台的流程一般如下所示：

1.注册账号。对接前首先需要注册账号，商家一般关联商家账号。ISV服务商注册服务商账号。

2.申请开发者账号。有了账号之后提供申请开发者权限的入口，进行开发者认证，经过审核后开通开发账号。

3.开通账号及授权。给开发者进行授权，提供相应的appkey、AppSecret。这时候可以提供测试环境和正式环节的账号。这个阶段需要给开发者提供API文档、SDK、测试工具。

4.对接测试。开发者进行正式的调试对接，如有需要，可安排相关人员支持。主要在测试环境进行。

5.申请上线。测试通过后，安排正式上线，有些正式上线需要平台批准，例如ISV服务商上线应用需要提交申请。

6.正式运行。对接完成上线后就可以正式使用了。

? 3??? ?详细业务? ??

聊完大框架，我们可以来具体聊聊业务了。对于电商开放平台，需要开发哪些接口，都是根据业务来确定的。开放平台没有标准的接口list，往往是发展到不同阶段，会开放不同的能力。

电商最核心的莫过于商品、订单两部分，我们就以商品为例，来分析下业务方面的设计。

商品

商品是最基础的数据，我们先想想商品的结构：类目、品牌、属性、规格、价格、库存、名称、描述等，如果我们要新增商品，首先基础数据就需要类目、品牌、属性、规格等相关的数据接口。获取到基础数据后，才可以新建商品，最后才是新增商品的接口。

有了新增商品的接口，还有商品数据的查询与更新。查询又分为单个查询和批量查询。

日常商品的管理，还需要上下架、价格、库存的管理。这样想来商品的接口也有很多了。除了思考需要哪些接口，我们还要考虑哪些入参和出参。

以下是拼多多的商品接口list，我们可以看到不同的接口有不同的功能。感兴趣的朋友可以搜索“拼多多开放平台”查看。

以单个商品查询为例，入参是商品编码（SKUid），出参是商品的详细信息，包括类目、品牌、属性、规格、价格、库存、名称、上下架状态、描述等内容。

出参的内容不是固定的，而是根据平台业务类型、使用需求所确定。

? 4??? ?扩展? ??

当业务发展到一定阶段，开放平台是做电商必不可少的部分。可以帮助企业快速扩展业务。开放平台可以简单做，也可以复杂做。深入可能更偏技术型，对每个接口、每个开发方进行监控。

在一些大型互联网公司，随着公司的业务发展逐渐庞大，需要和外部合伙伙伴进行合作，需要将公司的接口开放给外部其他合伙伙伴进行调用。比如腾讯的 QQ互联网、微信开放平台、蚂蚁金服开放平台?、钉钉开放平台、微博开放平台。在大型集团公司中，分为总公司和旗下多个分公司，总公司与分公司相互通讯也可以采用开放平台形式对接口进行授权。

电商业务发展过程中，开放平台面向的对象会由平台商家，然后到供应商、物流服务商、软件服务商、广告联盟成员等。

你们平台的开发平台可以实现哪些业务，欢迎一起讨论！

---