1、奇门请求流程图

2、选择所需要接入的API接口

3、填写测试环境和正式环境的地址

4、代码前置准备

4.1 appkey和appsecret

    商家可以进入控制台https://console.open.taobao.com/#/index，进入自己所创建的应用并在概览标签下查看自己创建应用的App Key（应用唯一标识，平台通过appkey鉴别应用身份）和App Secret（平台分配的密钥，用来保证应用来源的可靠性，防止被伪造，需要妥善保存）

4.2 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

4.3 下载SDK

    进入SDK下载的标签页，下载对应语言版本的SDK并进行开发（下载前请先检查是否已经申请了相对应的权限包）

    注：点击下载后，需要手动执行刷新界面操作才能知晓当前SDK是否已经下

5、编写代码（示例Demo）

5.1 将SDK下载后解压出来jar包引入到项目中（以Java为例）

<!-- 应用SDK的jar包 -->
<dependency>
  <groupId>com.taobao.api</groupId>
  <artifactId>taobao-sdk-java</artifactId>
  <version>20221208</version>
  <scope>system</scope>
  <type>jar</type>
  <systemPath>${project.basedir}/src/main/resources/lib/taobao-sdk-java-auto_1663138347043-20221208.jar</systemPath>
</dependency>

5.2 使用SpiUtils.checkSign()进行验签（推荐使用）

    使用SDK包中的checkSign()方法来进行验签，不建议使用自己构造的签名来进行验签。

5.2.1 成功回应示例

    参照接入接口文档中的成功返回示例进行返回接口响应的结果

5.2.2 验签失败回应示例

    参照接入接口文档中的成功返回示例进行返回接口响应的结果

5.2.3 核心代码示例以及完整demo示例

    以下为验签核心代码示例：

@RequestMapping(value = "memberRegister", method = RequestMethod.POST)
public String memberRegister(HttpServletRequest httpServletRequest) {
    //可以进行提取公共参数
    String appKey = httpServletRequest.getParameter("app_key");
    String method = httpServletRequest.getParameter("method");
    String sign = httpServletRequest.getParameter("sign");
    String timestamp = httpServletRequest.getParameter("timestamp");
    //获取unix_timestamp信息
    String unixTimestamp = httpServletRequest.getParameter("unix_timestamp");

    String returnResult = "";
    CheckResult checkResult = new CheckResult();
    try {
        //使用SpiUtils.checkSign()来进行验签
        checkResult = SpiUtils.checkSign(httpServletRequest, QimenConstant.APP_SECRET);
        System.out.println("验签的结果为:" + checkResult.isSuccess());
        if (checkResult.isSuccess()) {
            //获取body中的数据
            HotelBodyEntity bodyEntity = JsonObjTool.jsonToPojo(checkResult.getRequestBody(), HotelBodyEntity.class);
            //获得body中的请求参数信息
            String fliggy_user_name = bodyEntity.getFliggy_user_name();
            String phone = bodyEntity.getPhone();
            String apply_id = bodyEntity.getApply_id();
            System.out.println(bodyEntity);
            //写具体的业务逻辑，这里例举一个demo
            if (!StringUtils.isEmpty(method)) {
                HotelResponseEntity entity = new HotelResponseEntity();
                entity.setResult_code("SUCCESS");
                entity.setResult_message("ok");
                HotelResponseEntity.HotelResponseMap map = new HotelResponseEntity.HotelResponseMap();
                map.setCard_number("0X1234");
                map.setCustomer_id("abcd1234");
                map.setEffective_date(1546272000L);
                map.setExpire_date(1577808000L);
                map.setCard_level("V1");
                map.setExtension("{\"xxx\":1}");
                map.setPoint(10L);
                map.setIs_new(1L);
                map.setCustomer_status(1L);
                map.setPartner_member_id("0X1234");
                map.setCard_status("有效");
                entity.setData(map);
                return JsonObjTool.objectToJson(entity);
            } else {
                //模拟逻辑失败返回
                return "{\"error_response\":{\"msg\":\"Remote service error\",\"code\":50,\"sub_msg\":\"非法参数\",\"sub_code\":\"isv.invalid-parameter\"}}";
            }
        } else {
            System.out.println("sign验签不通过");
            //返回奇门验签失败的错误结果;
            return "{\"result_message\":\"Illegal request\",\"result_code\":\"sign-check-failure\"}";
        }
    } catch (IOException e) {
        e.printStackTrace();
    }
    return returnResult;
}

//获取body中的数据
HotelBodyEntity bodyEntity = JsonObjTool.jsonToPojo(checkResult.getRequestBody(), HotelBodyEntity.class);

6、测试地址可用性检测

    写完代码后发布到公网测试服务器上，对地址进行可用性检测，点击开始服务检测即可

    进行地址可用性检测，通过后，可进行下一步，并在正式环境上进行地址检测，通过后服务发布上线。

7、接入完成

    服务上线后，与群内对接的飞猪技术同学进行回复相对应的接口接入已完成。