在途商旅
  1. 2、单点登录
在途商旅
  • 关于本文档
  • API调用指南
    • API列表
    • 接入流程
    • 接口通用说明
    • 通用错误码
  • 服务端接口
    • 一、鉴权管理
      • 1、接口鉴权
        • a、获取token
      • 2、单点登录
        • a、目标页概述
        • b、单点登录
          GET
    • 二、企业信息
      • 1、概述
      • 2、组织单位
        • a、概述
        • b、常见问题
        • c、场景说明
        • d、组织同步
        • f、负责人同步
      • 3、员工信息
        • 概述
        • 场景说明
        • 常见问题
        • 手机号国家编码表
        • 员工同步
        • 员工直属主管同步
        • 员工常住地同步
        • 获取职级列表
        • 获取证件类型
        • 员工信息查询
      • 4、成本中心
        • 概述
        • 常见问题
        • 场景说明
        • 成本中心(部门所属)
        • 成本中心(员工所属)
      • 5、项目
        • 概述
        • 常见问题
        • 场景说明
        • 项目同步
      • 6、法人
        • 概述
        • 常见问题
        • 法人同步
    • 三、业务数据
      • 1.出行前
        • 概述
        • 差旅申请
          • 申请单同步
          • 申请单变更前校验
          • 取消申请单提前验证
          • 申请单状态变更
          • 获取申请单
          • 获取申请单使用状态
          • 获取申请单出行概况
          • 获取差旅类型
          • 获取费用类型
      • 2.出行中
        • 订单
          • 客票状态
          • 订单查询(全量)
          • 订单查询(分页)
          • 订单确认-V1
          • 订单确认-V2
      • 3.出行后
        • 账单
          • 获取账单主信息
          • 分页获取账单主信息
          • 获取账单订单明细
          • 账单中疑异订单通知
          • 确认账单通知
        • 票据
          • 订单开票信息
          • 个付电子发票查询
          • OCR票据查询
          • 订单数电票
      • 4.工作流
        • 查询审批记录
        • 审批结束通知
        • 审批记录同步
    • 四、事件订阅
      • 1、概述
      • 2、事件列表
      • 3、数据推送
      • 4、示例代码
      • 5、需求单服务类型
      • 8、openapi-sdk
      • 6、事件订阅接口
        • a、订阅事件
        • b、删除订阅
        • c、查询订阅
    • 五、通用数据
      • 国家编码对照表
      • 获取城市列表(废弃)
      • 获取城市列表V2
    • 六、其他
      • 补贴查询
      • 自定义补贴场景明细同步
  1. 2、单点登录

a、目标页概述


注意事项#

📌
为了维护页面的完整性和安全性,暂不支持将在途的页面嵌套到 iframe 框架中。请确保您的应用程序中未使用 iframe 嵌套我们的页面。

资源定义#

此接口用于获取指定编号员工登录到在途系统的自动登录链接。浏览器访问该链接将能自动免密登录到在途系统。

登录后跳转目标页可选项#

目标页枚举目标页描述特殊说明
ORDER_LIST_ALL订单列表页
ORDER_LIST_FLIGHT机票订单列表页(仅支持H5)
ORDER_LIST_HOTEL酒店订单列表页(仅支持H5)
ORDER_LIST_TRAIN火车订单列表页(仅支持H5)
ORDER_LIST_CAR用车订单列表页(仅支持H5)
BOOKING_FLIGHT机票预订首页
BOOKING_HOTEL酒店预订首页
BOOKING_TRAIN火车预订首页
BOOKING_CAR用车首页(仅支持H5)
EXPENSE_HOME报销系统首页(仅支持H5)
ORDER_DETAIL订单详情页面(需要同时传参数orderId)
FLIGHTLIST国内机票搜索页bookingParam 参数必传
HOTELLIST国内酒店搜索页(不建议使用)bookingParam 参数必传
TRAINLIST国内火车搜索页bookingParam 参数必传
INTELFLIGHTLIST国际机票搜索页(仅支持H5)bookingParam参数必传
CARLIST国内用车搜索页(仅支持h5)
BILL_LIST_ALL结算账单查询(仅支持PC)
BIDRIVER_TRAVEL_OVERVIEW差旅分析报告概览(仅支持PC)
BIDRIVER_MULTIDS_SAVING多维节支分析(仅支持PC)
BIDRIVER_TRAVEL_ORDER差旅订单汇总查询(仅支持PC)
WF_NOTIFY待办任务
HOTEL_BIND酒店会员绑定(仅支持h5)
CAR_PLAN_DETAIL用车填单页(仅支持h5)
INTELLIGENT_TRAVEL智能行程规划(仅支持h5)

bookingParam各业务线参数说明#

BOOKING_FLIGHT 机票预订首页
参数名称数据类型说明
fromDateString出发日期,如2014-01-12
fromCityCodeString出发城市三字码
toCityCodeString到达城市三字码
fromCityIdString出发城市ID
toCityIdString到达城市ID
fromCityNameString出发城市名称
toCityNameString到达城市名称
airRangeTypeString航程类型: OW 单程, RT 联程, OJ 联程 默认OW
isBusinessInteger是否公务出行:1:因公 0:因私 默认1
BOOKING_HOTEL 酒店预订首页
参数名称数据类型说明
cityIdString入住城市ID
fromDateString入住日期
cityNameString入住城市名称
toDateString离店日期
isBusinessInteger出行类型 :因公 1 因私0 默认1
BOOKING_TRAIN 火车预订首页
参数名称数据类型说明
fromDateString出发日期,如2014-01-12
fromCityNameString出发城市站名称
toCityNameString到达城市站名称
fromCityIdLong出发城市ID
toCityIdLong到达城市ID
isBusinessInteger是否公务出行 :因公 1 因私0 默认1
FLIGHTLIST 机票搜索页
参数名称数据类型说明是否必填默认值
fromDateString出发日期(yyyy-MM-dd)是
fromCityCodeString出发城市三字码是(fromCityId 二选一)
toCityCodeString到达城市三字码是(toCityId 二选一)
fromCityIdString出发城市id是(fromCityCode 二选一)
toCityIdString到达城市id是(toCityCode 二选一)
fromCityNameString出发城市名称|是
toCityNameString到达城市名称|是
airRangeTypeString航程类型: OW 单程, RT 联程, OJ 联程否OW
isBusinessInteger是否公务出行:1:因公 0:因私否1
travelPlanIdString差旅计划号否
INTELFLIGHTLIST 国际机票搜索页
参数名称数据类型说明是否必填默认值
airRangeTypeString航程类型: OW 单程, RT 联程, OJ 联程是OW
searchInfos[SearchInfo]航程信息列表是
isBusinessInteger是否公务出行:1:因公 0:因私否1
SearchInfo 参数说明
参数名称数据类型说明是否必填默认值
fromDateString出发日期(yyyy-MM-dd)是
fromCityString出发城市三字码是(fromCityId 二选一)
toCityString出发城市三字码是(toCityId 二选一)
fromCityIdString出发城市id是(fromCity 二选一)
toCityIdString到达城市id是(toCity 二选一)
fromCityNameString出发城市名称是
toCityNameString到达城市名称是
fromRegionTypeString出发机场类型 0(国内) 1(国际))否0
toRegionTypeString到达机场类型 0(国内) 1(国际))否0
travelPlanIdString差旅计划号否
HOTELLIST 酒店搜索页
参数名称数据类型说明是否必填默认值
cityIdString城市id是
fromDateString入住日期(yyyy-MM-dd)是
cityNameString入住城市名称是
toDateString离店日期(yyyy-MM-dd)是
isBusinessInteger出行类型 :因公 1 因私 0否1
travelPlanIdString差旅计划号否
TRAINLIST 火车搜索页
参数名称数据类型说明是否必填默认值
fromDateString出发日期(yyyy-MM-dd)是
fromCityNameString出发站名称是(fromCityId 二选一)
toCityNameString到达站名称是(toCityId 二选一)
fromCityIdLong出发城市id是(fromCityName 二选一)
toCityIdLong到达城市id是(toCityName 二选一)
isBusinessInteger是否公务出行 :因公 1 因私0否1
travelPlanIdString差旅计划号否
CARLIST 用车搜索页
参数名称数据类型说明是否必填默认值
carSceneCodeString用车场景code参数是
CAR_PLAN_DETAIL 用车填单页
参数名称数据类型说明是否必填默认值
sourceString使用该目标页是,该参数必填:固定值sso是
INTELLIGENT_TRAVEL 智能行程规划页
参数名称数据类型说明是否必填默认值
planNoString申请单编号;注意此参数与target同级,无需放置在bookingParam对象中,当此字段未传则会跳转到预定首页否-1
返回说明
正常情况下,返回如下格式的数据:
{
    "error": "0",
    "data": "https://www.z-trip.cn/home/index.html?aaa=xxx"
}
参数说明
参数名称数据类型说明
errorString状态码
dataString用于登录的请求链接,此链接有效期5分钟
上一页
a、获取token
下一页
b、单点登录
Built with