背景

盒马平台与外部的商家对接的时候是使用的淘宝的开放平台，所以在对接之前需要了解开放平台以及对接过程中的一些核心的概念，如果了解清楚这些概念之后会节省接下来的对接时间。

核心概念

三方应用：

一般指工具的提供服务商，比如：ERP的提供商，WMS的提供商等。

开放平台：

对于开放平台的介绍，参考这个文档，点击这里访问。一句话说明就是，阿里实现了一套用于阿里和外部的系统做数据交互的系统。

网关：

阿里实现的一套系统，用于官方在网关上开放接口，三方通过网关获取数据。

奇门：

对于奇门的介绍，参考这个文档，点击这里访问。一句话说明就是，阿里实现了一套系统，用于阿里的系统调用三方的系统获取数据，或者三方的系统调用另外一个三方的系统获取数据。

数据交互方式

盒马平台与三方的数据交互方式有两种

1. 三方的系统通过网关获取盒马平台的数据。这种方式如下图所示。
   

2. 盒马平台通过奇门获取三方系统的数据，或者回流一些数据给到三方，这种方式如下图所示。
   

选用哪种交互方式： 这两种数据交互方式具体选用哪种，取决于具体的业务流程

• 如果盒马平台在做业务的流程中依赖三方的数据，如果获取不到三方的数据，则业务流程不能继续的，则需要开奇门接口，比如：pos获取会员信息的时候需要获取三方的数据，才能继续支付。这时候就需要开奇门接口，然后让三方实现
• 如果三方的业务流程是通过盒马平台产生的数据驱动继续的，则也需要开放奇门接口，数据通过奇门接口返回三方，三方的业务才能继续。
• 如果产生的数据没有实时返回，但是也并不影响双方的业务流程，则可以通过网关开放，让三方通过网关拉取数据。比如：库内操作的单据。
• 对于使用奇门还是网关交互数据，在盒马业务开放的时候已经确定好了，在接口调用节会讲述两种数据交互方式分别怎么使用。

沙箱

对于沙箱的的介绍，点击这里访问。简单来说就是用于开发测试的一套环境。

appkey&secret：

第三方开发者在开发应用调用盒马的top接口的时候都需要在开放平台申请一个appkey作为应用的唯一标识。secret是与appkey一一对应，类似于个人密码，不能对外泄露。主要用途是在isv发起接口调用的时候对请求参数做md5，防止数据被篡改。

授权：

数据是商家的，而获取数据的应用是第三方的。所以数据在给到三方的应用获取的时候需要得到商家的授权。

环境介绍：

对于对接的环境，有如下三套环境：

1. 开发测试环境：这个环境主要是用于开发，测试。各个系统之间的调用关系如下图
   
2. 预发环境：预发环境是代码发布到正式环境之前的一个验证环境，使用的数据都是正式环境的真实的数据。但是运行的代码是新的代码。
3. 正式环境：真正对外服务的环境。预发环境验证没问题之后就会把代码发布到正式环境。正式环境和预发环境的各个系统之间的调用关系如下图
   

FAQ

关于此文档暂时还没有FAQ