在途商旅
  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、单点登录

b、单点登录

测试环境
https://openapi-uat.z-trip.cn
测试环境
https://openapi-uat.z-trip.cn
GET
/tmc/v1/sso-url
此接口用于获取指定编号员工登录到在途系统的自动登录链接。登录后可根据需要跳转到不同的目标页面,可查看 “目标页概述” 中的详细定义

请求参数

Query 参数
access_token
string 
访问凭据
必需
示例值:
{{openApiToken}}
empCode
string 
可选
员工编号;和mobile配合使用,二者有一个即可
示例值:
0555
mobile
string 
可选
员工手机号;mobile优先级低于empCode,如果两个字段都传,会优先empCode
示例值:
13173632843
system
string 
可选
系统标识,pc - 获取pc端登录地址(默认);h5 - 获取h5端登录地址
示例值:
h5
target
string 
可选
跳转目标页。默认为首页,其他可选择参考
目标页概述:https://apifox.com/apidoc/shared-dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-2253025
示例值:
BOOKING_HOTEL
orderId
string 
可选
订单编码;当target= ORDER_DETAIL时,此字段必传
示例值:
10102001000301
taskId
string 
可选
任务id,跳转到对应的待办任务页(target传入WF_NOTIFY时此字段必填)
示例值:
123
planNo
string 
差旅计划编号
可选
示例值:
123123
bookingParam
string 
可选
预订信息, 该参数需要进行url编码,下述样例为编码前的样例 机票样例:{"fromCityId":"2121","toCityId":"21232","fromCityName":"上海","toCityName":"北京","fromDate":"2021-05-04"} 酒店样例:{"cityId":"2121","cityName":"上海","fromDate":"2021-05-01","toDate":"2021-05-04"} 火车样例:{"fromCityId":"2121","toCityId":"21232","fromCityName":"北京","toCityName":"上海","fromDate":"2021-05-04"}
示例值:
%7B%22fromCityId%22%3A%222121%22%2C%22toCityId%22%3A%2221232%22%2C%22fromCityName%22%3A%22%E4%B8%8A%E6%B5%B7%22%2C%22toCityName%22%3A%22%E5%8C%97%E4%BA%AC%22%2C%22fromDate%22%3A%222021-05-04%22%7D
travellerParam
string 
可选
出行人信息,员工编码必传。 该参数需要进行url编码,下述样例为编码前的样例 样例:[{"empName":"张三","empCode":"zhangsan"}]
示例值:
%5B%7B%22empName%22%3A%22%E5%BC%A0%E4%B8%89%22%2C%22empCode%22%3A%22zhangsan%22%7D%5D
costUnitCode
string 
成本中心编码
可选
示例值:
0011
simple
string 
可选
是否显示回退按钮,true - 不显示回退按钮,false - 显示回退按钮,默认为false
示例值:
true
lang
string 
可选
zh_CN:汉语;en_US:英语 。默认 zh_CN
示例值:
en_US

返回响应

🟢200成功
application/json
Body
object {0}
示例
{
    "error": "0",
    "data": "https://m-uat.z-trip.cn/home?alp=AFF553B79ECB947A2C822DB9062333A93C71A8CFEFCC66CE9B7C450974CCFF0BB0ADCCB8E3F225FE84AC05F68B2FB462",
    "error_description": "成功"
}
上一页
a、目标页概述
下一页
1、概述
Built with