1. 微盟开放平台概述

1.1 微盟云简介

微盟云将微盟多年沉淀的云平台和商业化能力，面向SaaS应用生态、运营服务生态、内容制作生态、定制开发生态、流量生态等优质生态合作伙伴全面开放，共同为国内和跨境商家孵化和输出商家运营、消费者连接和触达、新商业SaaS几个价值维度的多样性、专业化、行业化的新商业解决方案及服务。
微盟云平台简介：https://cloud.weimob.com/saas/word/detail.html?tag=1079&menuId=2

1.2 微盟云接入方式

微盟云目前主要有以下三种接入方式：
1.软件服务商
通过微盟云服务市场为商家提供店铺管理、客户管理、营销推广、智能客服等服务工具，满足商家多元化需求。
2.非软件服务商
通过微盟云服务市场为商家提供硬件设备、视觉设计、短视频拍摄、礼品供应等服务。
3.商家自研发或商家软件供应商

1.3 微盟云能力介绍

微盟云目前提供了700+个API与消息推送服务，实现商家各业务系统的数据互通，打破数据壁垒，集中、高效的管理自己的业务数据。通过扩展点功能，可实现自定义店铺页面与业务逻辑的个性化定制。

1.OpenAPI
微盟云提供订单，商品，营销，店铺，客户等多种API实现线上线下数据互通功能。

2.消息推送
当业务场景满足某个消息触发的条件时，微盟云消息推送系统会从业务中台收到该条消息，推送系统对消息进行预处理后，会将消息分发给满足条件的应用。

3.自定义页面&页面组件
微盟云通过前端扩展点能力，为每个可定制的页面都提供了一系列组件供开发者定制，这些组件在页面的位置是固定的；同时也可以完全自定义一个页面，包含H5页面、微信小程序、支付宝小程序、百度小程序等多个第三方平台页面的自定义改造，满足商家的多场景的小程序定义开发需求。

4.扩展点API
扩展点api，又叫后端扩展点，分为业务扩展点和消息扩展点。业务扩展点是在微盟现有saas业务进行了自定义扩展，开发者可通过扩展点自定义一些内部系统的流程节点的执行逻辑，改变系统部分功能以接近预期，消息扩展点开发者可以根据自身需求，在实现流程中加入相应的逻辑处理。

5.APP开店
微盟为满足商户通过移动应用搭建自有商城、打通全渠道店铺的业务诉求，将微盟的电商交易系统以SDK及H5嵌入形式开放出来，赋予开发者应用丰富的电商功能。

微盟云开放能力介绍：http://doc.weimobcloud.com/word?tag=1098&menuId=2

2. 微盟授权商户自用对接

2.1 微盟授权业务需求

由于是公司自用开发需要与微盟对接获取商品酒店数据，因此此次选择的是商户自用对接，如果是要做sass产品帮助市场上所有商户做数据管理，营销推广等信息需要选择服务商对接。
业务开发中需要对接微盟开放平台，同步微店商品信息，因此需要获取token信息，微盟开放平台在提供的方案是通过授权码获取token，通过刷新token获取新的token信息，但是存在一个问题就是，获取授权码没有通过API的形式，也就是说你需要不停的刷新token，来保持新的token的可用性，一旦刷新中断，需要手动获取授权码信息。目前市场上满足OAuth2.0协议的产品springsecurity，提供了四种获取token的方式，可以满足不同应用场景，但是微盟这种通过code授权码的方式着实不太友好，对于后端开发来说。
微盟授权商户自用对接实现是通过springboot+openfeign+redis实现。OpenFeign实现动态url调用rest接口，redis用来存储code，accessToken，refreshToken。

2.2 微盟商户授权流程

通过微盟后台应用配置接收code的url，每次授权需要到微盟后台点击授权，会通过GET方式自动跳转到配置URL并把code与stste一同拼接到url带过去，只需要提供可访问的rest api即可，拿到code放入缓存以便获取accessToken使用，通过定时任务获取accessToken，同时将accessToken与refreshToken放入缓存，然后通过定时任务在accessToken失效时间内通过refreshToken不间断的刷新accessToken，保证accessToken可用性。
需要注意的是，微商城的授权码与智慧酒店的授权码是互不通用的，而且不同的店铺的授权码也是不能通用，比如普通店铺与豪华版店铺是不通的，授权码只能使用一次，且有哟有效时间。

2.3 微盟商户授权步骤

微盟商户授权大致分为三步，首选是在微盟配置中心配置应用，然后通过开发提供接口服务用于接收微盟授权的时候发送的请求，最后是是在微盟配置中心选择对应应用点击授权，通过上一步的服务接收授权。
微盟商户自用对接：https://cloud.weimob.com/saas/word/detail.html?tag=564&menuId=2

1.登录微盟后台：https://account.weimob.com/login.html
2.进入对应的解决方案店铺-开发者中心
3.创建应用，应用名称和简介自行填写
4.查看应用，获取CLIENT_ID及CLIENT_SECRET
①应用列表中，点击“API权限”查看CLIENT_ID及CLIENT_SECRET（可复制出放在TXT文档中，便于后续拼接请求链接）
②点击“配置”，填写应用跳转地址（填一个可以正常跳转地址，该地址用于接收平台code等），跳转地址用来接收code使用。这里可以配置一个可以使用的地址即可，但是无法通过后台自动接收code，比如通过www.baidu.com，选择店铺点击授权，会跳到百度页面并带上code，如果配置一个自定义的API，就可以实现后台自动接收code。
5.获取授权码，点击授权，选择店铺

6.跳转地址获取授权码 code=eBEOs3
回调授权地址获取授权码：https://www.baidu.com/?code=eBEOs3&state=custom

3. 微盟授权服务商对接

微盟服务商对接：https://cloud.weimob.com/saas/word/detail.html?tag=565&menuId=2

4. 微盟授权微信C端授权

微信C端授权文档：https://cloud.weimob.com/saas/word/detail.html?tag=566&menuId=2

5. 获取微盟商品信息

5.1 获取微盟商品信息概述

开发对接微盟开放平台获取商品信息的方式有两种，一种是主动拉取商品信息，第二种是通过微盟开放平台消息触发推送商品信息。

5.2 普通API与消息API

普通API：商品，库存，类目等API属于调用微盟接口。
消息API：属于微盟商品变更通知外部系统的机制，调用外部接口。
注意事项：普通api调用不需要配置，有token即可调用，消息api需要配置接收地址与订阅。

5.3 微盟普通API

微盟普通API文档：https://cloud.weimob.com/saas/word/list.html?tag=190&menuId=1

5.4 微盟消息API

微盟消息API文档：https://cloud.weimob.com/saas/word/detail.html?tag=1102&menuId=2

1.配置消息API地址：开发者中心-应用列表-API权限
2.API消息订阅服务-开启订阅，订阅网址一定要可用才能保存，提供的订阅网址是POST请求，参数是linkedHashMap，不必传@RequestBody(required = false)，要不然掉不通保存不了。
接口权限列表-消息订阅接口：选择对应类目进行测试与订阅。

3.开启服务接收
上述配置完成，只需要开启服务接收即可。达到触发条件，不如商品上下架，发布，创建等就会回调配置的URL，接收相关服务，解析入库即可。