综合交通-商家对接
1、接入准备（入驻开放平台）
1.1 店铺商家
详细参考文档：https://fliggy.open.taobao.com/doc.htm?docId=104812&docType=1
具体流程：
1.2 系统商ISV
详细参考文档：https://fliggy.open.taobao.com/doc.htm?docId=104810&docType=1
具体流程：
1.3 关注点
1.3.1 选择对应场景的标签
店铺商家或系统商ISV在创建应用的时候，选择自己应用所对应的场景标签，如：进行用车接入，则申请 飞猪-度假 标签，并申请满足自己应用需求的所需要的权限包。
1.3.2 appkey和appsecret
店铺商家或系统商ISV在创建完应用之后可以进入控制台https://console.open.taobao.com/#/index，进入自己所创建的应用并在概览标签下查看自己创建应用的App Key（应用唯一标识，平台通过appkey鉴别应用身份）和App Secret（平台分配的密钥，用来保证应用来源的可靠性，防止被伪造，需要妥善保存）
1.3.3 session key
概念：
session Key是店铺授权给应用的有效凭证。
- 状态为上线运行中、安全等级是3级的应用获取的session key有效期是3个月
- 状态为正式环境测试中的应用获取的session key有效期只有24小时
- session key过期都需要重新授权，不支持刷新机制
两种授权方式：
- ISV实现OAuth 2.0协议，具体参考链接：https://open.taobao.com/doc.htm?docId=118&docType=1
- 使用开放平台提供的临时链接获取，具体获取链接：https://fliggy.open.taobao.com/apitools/sessionPage.htm?spm=a219a.7386653.0.0.63b3669adedlRd
1.3.4 下载SDK
进入SDK下载的标签页，下载对应语言版本的SDK并进行开发
注：点击下载后，需要手动执行刷新界面操作才能知晓当前SDK是否已经下载完成
2、入驻奇门
飞猪在与商家进行对接的时候，有些业务涉及到飞猪平台主动调用商家的接口的场景，这种情况（如：飞猪用车的接送机、用车）需要商家入驻奇门开放平台。
大致流程：入驻奇门 -> 选择官方场景 -> API实现 -> API自测 -> 发布上线 -> 配置授权 -> 对方调用
2.1 申请成为奇门开发者
登陆奇门开放平台，提交开发者信息
2.2 将appKey发送给飞猪技术支持同学
获取到上述自己创建新应用的appKey并将其发送给飞猪技术支持同学，让其在奇门场景（老）进行添加配置
2.3 申请奇门官方场景授权
选择自己应用所要关联的官方场景，如租车、接送机场景，选择应用和填写关联描述，并进行确认提交
2.4 奇门接口API实现
点击确认提交后会进入到API列表界面，如下图所示
2.4.1 下载官网SDK导入项目中进行开发
下载按对应版本的依赖后，解压后会出现2个jar包，分别将他们导入到要开发的项目工程中。
步骤如下：
- 在resource目录下新建一个lib目录，将解压后的两个jar包导入到lib目录下
- 在dependecy依赖下引入这两个依赖坐标，示例依赖代码如下所示，由于下载后jar包名字会发生变化，需要修改下systemPath对应的jar包名字以及其所对应的artifactId的值
2.4.2 接口汇总
租车场景中，奇门接口（飞猪请求商家）目前共有6个接口，对应的链接中包含了入参和相对应的返回值信息，根据定义的API来开发对应的实现逻辑
汇总：https://open.taobao.com/api.htm?docId=29535&docType=2&scopeId=12567
- 租车车辆报价详情接口（qimen.alitrip.rentcar.cardetail.query）：//open.taobao.com/api.htm?docId=29712&docType=2
- 租车报价列表搜索接口（qimen.alitrip.rentcar.prices.query）：//open.taobao.com/api.htm?docId=29545&docType=2
- 提交订单接口（qimen.alitrip.rentcar.order.submit）：//open.taobao.com/api.htm?docId=29535&docType=2
- 取消订单接口（qimen.alitrip.rentcar.order.cancel）：//open.taobao.com/api.htm?docId=29546&docType=2
- 订单状态查询接口（qimen.alitrip.rentcar.order.query）：//open.taobao.com/api.htm?docId=29547&docType=2
- 提交订单前校验是否可下单接口（qimen.alitrip.rentcar.order.check）：https://open.taobao.com/api.htm?docId=62654&docType=2
接口实现完成之后，为了防止接口被人乱掉用，需要在服务端做验签的逻辑，校验请求的合法性。
验签算法推荐使用官方提供的SpiUtils.checkSign()方法，范例验签Demo可以参考：?rentcar.rar
附：TOP接口（商家回调飞猪，需申请飞猪旅行用车权限包）
国内租车订单状态更新接口：//open.taobao.com/api.htm?docId=41576&docType=2
2.5 API接口自测
（1）、填写测试地址，需要填写以下两张图上的位置：
- 自测的时候，先填写服务后端测试URL地址（这个地址必须为公网能够访问的网址），如果没有正式url地址的话可以随便填写一个，如https://www.baidu.com/，等后续自测通过完成了，再来进行修改正式URL地址。
服务后端测试URL示例：http://qimentest.fliggy.top/orderquery
- 在创建应用的 应用设置-配置信息 下填写回调URL的地址，填写完成后点击保存
回调URL示例：http://qimentest.fliggy.top/
（2）、根据奇门的接口文档来编写对应的响应成功和响应失败的返回信息
（3）、进入到自测环境中
推荐在官方的自测场景中进行验证（包含验签的操作），不推荐在Postman中进行测试。
若遇到验签失败，可查看示例Demo?rentcar.rar
（4）发起提交测试
（5）发起服务验证
（6）、验证通过
（7）、点击发布
返回奇门控制台界面，可以看到整个接口的状态已经为已发布了
2.6 联系飞猪技术支持人员进行联调测试
验收场景：
- 搜索（取还车地址相同），搜索（异地还车）
- 搜索，下单，商家接单，用户取消订单
- 搜索，下单，商家接单，用户取车，用户还车，服务完成
2.7 添加授权（接口自测通过后进行联调验收环节）
授权配置给飞猪appkey：奇门后台作下授权配置，允许飞猪appkey：23791897 调用接口
在奇门授权界面中，也可以看到是自己的应用 授权给了 飞猪应用，即：飞猪调用商家
新增授权配置之后，配置奇门授权，同步各接口服务地址
3、申请业务参数配置
包含商家服务时间及客服设置等信息，具体链接可以查看：https://fliggy.open.taobao.com/doc.htm?docId=118654&docType=1
