在途商旅
API调用指南
复制页面
在途商旅
关于本文档
API调用指南
API列表
接入流程
接口通用说明
通用错误码
服务端接口
一、鉴权管理
1、接口鉴权
a、获取token
2、单点登录
a、目标页概述
b、单点登录
二、企业信息
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
六、其他
补贴查询
自定义补贴场景明细同步
API调用指南
复制页面
接入流程
概述
#
服务端 API 的调用流程如下图所示。
申请权限
#
企业与在途沟通并确认对接方案后,在途为企业开设对接账号 client_id 和密钥 client_secret
获取访问凭证
#
接口鉴权
设置IP白名单
#
为了提高应用访问的安全性,开发者可以通过 IP 白名单功能设置能够合法访问在途服务端 API 的 IP 列表,不在白名单列表中的 IP
地址的请求会被拒绝,并返回错误提示信息。
调用API
#
为了让开发者可以便捷地调用 API,在途商旅提供了在线接口调试工具,本文介绍基本的 API 调用方法。
基本要求
申请权限、获取访问凭证、设置 IP 白名单之后,才能调用服务端 API。
调用 API 时,需要将访问凭证放入参数列表 中( access token)。
调用服务端 API 时,需要使用 HTTPS 协议、UTF-8 编码。
上一页
API列表
下一页
接口通用说明