# 原生代码接入
# 接入流程

- 接入方与腾讯出行服务协商确认接入的业务范围,输出需求文档进行评审;
- 腾讯出行服务提供接口请求、埋点上报、openId、手机号等平台能力;
- 接入方按要求开发相应的功能模块,并自测通过,符合接入标准;
- 腾讯出行服务根据接入方提供的验收材料(源码、用例、接口地址、压测报告等)集成验收;
- 验收达标后发布上线,并通知接入方进行回归验证;
# tms 框架
腾讯出行服务模块开发环境可通过 @tmsfe/tmskit (opens new window) 快速构建,提供以下能力:
- 出行服务小程序模拟首页及模块入口;
- 统一网关接口请求(测试环境);
- 获取用户唯一标识 openId (用于订单同步);
- 获取用户当前城市、授权状态等平台能力;
- 提供自定义顶栏等标准公共组件;
更多功能及使用方法,请前往 TMS 框架 了解。
# 网关接入
统一网关调用关系:
注意事项:
- 接入方业务接口域名,尽量使用同一个域名;
- 接入方业务所用接口,一级路径将收敛到同一模块名下(如:
/bus/**/**); - 支持 https + json 方式接入,如有特殊需求须在接入时说明;
- 业务方需验证请求来源时,可使用网关提供的二次签名能力,将转发给下游的请求进行二次签名。业务方验证该签名的有效性即可。参见网关接入详细说明
# 订单同步
订单同步分两部分:
- 接入方后台将订单信息同步至出行服务后台,接口参见 文档 ;
- 接入方前端提供订单详情页面路径及参数;
# 集成验收
接入方提供可访问的 git 仓库地址,腾讯出行服务获取代码并集成模块。
验收标准参见 文档