Java对接微盟开放平台
Java对接微盟开放平台1. 微盟开放平台概述1.1 微盟云简介1.2 微盟云接入方式1.3 微盟云能力介绍2. 微盟授权商户自用对接2.1 微盟授权业务需求2.2 微盟商户授权流程2.3 微盟商户授权步骤3. 微盟授权服务商对接4. 微盟授权微信C端授权文档5. 获取微盟商品信息5.1 获取微盟商品信息概述5.2 普通API与消息API5.3 微盟普通API5.4 微盟消息API1. 微盟开放平
Java对接微盟开放平台
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,接收相关服务,解析入库即可。
更多推荐
所有评论(0)