# 原生代码接入

# 接入流程

原生代码接入流程

  • 接入方与腾讯出行服务协商确认接入的业务范围,输出需求文档进行评审;
  • 腾讯出行服务提供接口请求、埋点上报、openId、手机号等平台能力;
  • 接入方按要求开发相应的功能模块,并自测通过,符合接入标准;
  • 腾讯出行服务根据接入方提供的验收材料(源码、用例、接口地址、压测报告等)集成验收;
  • 验收达标后发布上线,并通知接入方进行回归验证;

# tms 框架

腾讯出行服务模块开发环境可通过 @tmsfe/tmskit (opens new window) 快速构建,提供以下能力:

  • 出行服务小程序模拟首页及模块入口;
  • 统一网关接口请求(测试环境);
  • 获取用户唯一标识 openId (用于订单同步);
  • 获取用户当前城市、授权状态等平台能力;
  • 提供自定义顶栏等标准公共组件;

更多功能及使用方法,请前往 TMS 框架 了解。

# 网关接入

统一网关调用关系:

注意事项:

  • 接入方业务接口域名,尽量使用同一个域名;
  • 接入方业务所用接口,一级路径将收敛到同一模块名下(如:/bus/**/**);
  • 支持 https + json 方式接入,如有特殊需求须在接入时说明;
  • 业务方需验证请求来源时,可使用网关提供的二次签名能力,将转发给下游的请求进行二次签名。业务方验证该签名的有效性即可。参见网关接入详细说明

# 订单同步

订单同步分两部分:

  1. 接入方后台将订单信息同步至出行服务后台,接口参见 文档
  2. 接入方前端提供订单详情页面路径及参数;

# 集成验收

接入方提供可访问的 git 仓库地址,腾讯出行服务获取代码并集成模块。

验收标准参见 文档