用车H5页面：

访问方式

调用单点登录接口(https://api.es.xiaojukeji.com/river/Login/getLoginEncryptStr)获取带有令牌的用车页面URL，并根据实际用车场景进行参数拼接

响应结果示例：

{ 
   "errno":0, 
   "errmsg":"SUCCESS", 
   "data":{
        "encrypt_str":"https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code=eyJ0X3N0ciI6Ijc0ZTJkNDhkNWU2Mjk0YzY2Zjg0ZWI4MmViODJhYzdhIiwiY19zdHIiOiIwOGFhNWFjNzFmZTYzNGViYTQyNjA4MjdmNThjODJhNyIsInQiOjE2MjQ2MjczMDksImhfc3RyIjoiNzA1MzVjMmQwNjczMWE3NWZkZjNiNzdkYzU4ODNkOTgifQ==&phone=11000000995&company_id=6991764971512422503&client_id=diditestclient" 
   },
        "request_id":"v7ohF6sWiDzQKHKxXtnXEHGTU9v7OhWqwQ5sDls5HlbUXxMB6PaXbiWOCTVg4I+a" 
}

接入方式

Native

通过 webview接入拼接参数后的用车页面 URL，如果有域名、链接等拦截的配置，需要对滴滴企业版 H5域名(https://open.es.xiaojukeji.com/)、微信支付、支付宝、tel协议等进行解除或加白操作
Web
- 使用location.href等浏览器原生方式进行跳转【推荐】
- 使用 iframe嵌套【不推荐】

提示

限制是指：如果选择【限制】某个参数时，员工在叫车过程中，不能对其修改，以传入参数为准
传入参数，如果有汉字时，建议先对其进行 encode 转换（encodeURIComponent）。否则可能会出现异常
单点登录链接是一次性有效，每次跳转都要单独获取 data.encrypt_str，建议在获取单点登录链接时增加防抖功能
通过手机号创建的员工，当首次单点登录时，会自动跳转到手机号验证页面，员工验证手机号后继续跳到 H5 指定页面。仅首次单点跳转需要验证手机号
auth_code 在单点用车请求时会返回

可拼接参数

地址信息相关

起点地址

名称	类型	示例	描述	备注
city_id	Number	1	起点城市 id
lat_from	Number	39.90254	起点纬度
lng_from	Number	116.40838	起点经度
poi_from_name	String	弘源·新时代西南门	起点地址名称
lat_cur	Number	39.90254	当前位置纬度	无法获取当前定位或有特殊要求此参数作为乘车人当前所在位置
lng_cur	Number	116.40838	当前位置经度	无法获取当前定位或有特殊要求此参数作为乘车人当前所在位置

终点地址

名称	类型	示例	描述
to_city_id	Number	1	终点城市 id
lat_ to	Number	39.90254	终点纬度
lng_to	Number	116.40838	终点经度
poi_to_name	String	弘源·新时代西南门	终点地址名称

机场/航班相关

名称	类型	示例	描述	备注
airport_id	Number	12098	机场 id	实时接/送机必传
flight_no	String	CZ8887	航班号	预约接机必传
flight_depart_date	String	2024-07-11	航班出发日期	预约接机必传

预约信息相关

名称	类型	示例	描述	备注
appointment_time	Stirng	“今天｜18:10”	预约用车时间	- 中间使用"\|"符号进行分割 - 前面部分可取今天、明天、后天 - 后面部分为时间格式 H:MM

制度规则相关

名称	类型	示例	描述	备注
rule_id	Stirng	112628299161	用车制度规则id	- 用车场景必传 - 因公用车须报销 rule_id 为 -2 - 自费用车 rule_id 为 -1

申请/差旅单相关

名称	类型	示例	描述	备注
approval_id	Stirng	112628299161	审批/差旅单id	- 配合 jumpPage可跳转到不同页面

订单相关

名称	类型	示例	描述	备注
order_id	Stirng	27181216348	订单id	- 无需配置 jumpPage可进入订单详情页面

成本中心相关

名称	类型	示例	描述	备注
restrict_budget_center	Number	0	限制成本中心	- 0 不限制 - 1 限制
budget_center_id	String	1764529863	成本中心 id

叫/乘车人相关

名称	类型	示例	描述	备注
passenger_phone	String	xxxxxxxxxxx	乘车人手机号	代叫时必传
passenger_phone_country_code	String	86	乘车人手机号国家码	乘车人手机号非大陆是必填
passenger_name	String	张三	乘车人姓名	代叫时必传，默认为passenger_phone
caller_phone	String	xxxxxxxxxxx	叫车人手机号	管理 API 客户必传
restrict_passenger	Number	0	是否限制乘车人	代叫时生效 0 - 否 1 - 是默认 0

jumpPage参数映射

名称	描述	备注
callCarNow	实时用车
callCarAppointment	预约用车	appointment_time必传
airportPickUp	预约接机	flight_no、flight_depart_date必传
airportPickUpNow	实时接机	airport_id必传
toAirport	实时送机	airport_id必传
stationPickUp	实时接站
toStation	实时送站
orderlist	订单列表
ruleList	制度中心
ruleDesc	制度详情	需要传入制度id(institution_id同 rule_id)
invoice	发票与报销
mywallet	我的钱包
homeAddress	常用地址设置	设置便捷起点和终点地址
travelList	差旅/审批单详情	需要传入差旅/审批单id(approval_id)
callCenter	客服中心
charteredCar	包车页面
certification	证照信息
user_policy	用户规则
privacyList	服务协议及个人信息处理

定制化参数相关

名称	类型	示例	描述	备注
restrict_poi_flag	1	1111	是否限制地点	四位字符串 ABCD； ABCD 分别表示是否锁定【起点城市】、【起点地址】、【终点城市】、【终点地址】 -其中 0 对应不限制、1 对应限制 -【如果 A 为 1 】，锁定【起点城市】需要使用参数 city_id -【如果 B 为 1】，锁定【起点地址】需要参数 lat_from 、lng_from 、poi_from_name，city_id -【如果 C 为 1】，锁定【终点城市】需要使用参数 to_city_id -【如果 D 为 1】，锁定【终点地址】需要参数 lat_to 、lng_to 、poi_to_name，to_city_id - 由于机场、火车站的特殊性，接机/站时，不要锁定出发城市、出发地；送机/站时，不要锁定目的城市、目的地
require_level_list	String	“100_1,400,1000”	控制可选车型	可参考自营车型列表及说明
append_car	string	举例： append_car [{ "start_time": "21:00", "end_time": "06:00", "end_time_cross_day": 1, //是否跨天，0否，1是 "wait_time": 1,//等待时间，单位分钟 "product_category_list": "5002,5003" // product_category用字符串拼接 }, { "start_time": "21:00", "end_time": "06:00", "end_time_cross_day": 1, "wait_time": 1, "product_category_list": "5004" } ] 需要urlencode	控制等待追加车型
callback_info	String	“{oderid: 1213123123}“	客户自定义自段，可关联订单信息	客户自定义自段，可关联订单信息示例：1、要传一个json字段： {a:1}2、转义：encodeURIComponent(JSON.stringify({a:1}))3、最终 callback_info=%7B%22a%22%3A1%7D4、客户需要自行decodeURIComponent后自行解析json
cross_city	string	0	是否允许跨城	0不允许 1允许不传递按照制度配置处理
cross_city_level	string	0	不允许跨城范围	0 地级市不允许跨城，1县级市不允许跨城 - 当cross_city=0不允许时，此字段默认为否，即地级市范围内不可跨城。如想更小范围控制在县级市范围，则需传1。 - 当cross_city=1允许时，该字段不传不会报错，传了也不会生效 - 当cross_city没传，该字段传参生效（仅当制度配置不允许跨城）
cross_city_pairs	string	(json字符串)[ { "start_id": "340811", "start_name": "宜秀区", "end_id": "340822", "end_name": "怀宁县" } ]需要urlencode	允许跨城城市对	- 当cross_city=1为允许时该字段才生效，如部分允许则需在此字段传城市对。如不传，则认为不限制，随便跨城。需要encode后拼在URL上 - 当cross_city=0时，该字段不生效当cross_city没传时，该字段传参不生 -【前置条件】客户需对接用车城市api，城市对需要传城市id和名称 -【注意】如果URL没拼，按没传处理，以制度配置为准。如果URL拼了参数则以传参为准，制度中该组件将失效。
change_destination	string	0	是否允许修改目的地	0 不允许修改 1 允许修改；不传默认允许修改如需修改目的地则需传1。
external_domain_version	string	0	部分协议网站是否启用新域名。	0 不启用 1 启用客户端微信小程序中跳转滴滴企业级H5页面时，需要启用此参数。建议传数字枚举 1

自营车型列表

名称	车型等级	详细车型
快车	600	5000
滴滴特快	600	5001
拼车	600	5003
优享	900	5002
舒适专车	100	5005
行政专车	200	5006
六座商务	400	5007
豪华车	1000	5009
企业特价快车	40600	5024
快的新出租车	1100	5004

说明

车型等级细分车型，如快车细分为普通快车、特快、拼车，以此类推。

【require_level_list】设置规则：

控制页面显示的可选车型
- 如果只传入车型等级，会显示对应车型等级下的所有详细车型，如require_level_list=600，会显示普通快车、特快、拼车
- 如果只传入详细车型，只会显示所传入的车型，如require_level_list=5001，只会显示特快，其他车型均不展示
控制车型默认勾选【车型标识后追加“_1”代表选中】
- 按车型等级设置勾选，会选中相应车型等级下的全部详细车型，如require_level_list=600_1,5001,5003,5000,普通快车、特快、拼车均被勾选
- 按详细车型设置勾选，只会选中相应详细车型，如require_level_list=600,5001_1,5003,只有特快被勾选

用车场景

实时用车

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code=eyJ0X3N0ciI6IjQ3YjI3MWRkODg4NDdjZDk0ZTg5ZTkwZDE4YzUyZmNjIiwiY19zdHIiOiJhNDA2Zjg5YTIwNmU0ODA5YTY0N2E0YTRiNmUzZWNlZSIsInQiOjE3MjcyMzE1MjgsImhfc3RyIjoiOGIwMWI5Y2U2ZWU5OThhY2QzYTc3MmZjZmJhMmVmYzEifQ==&company_id=1125927879116656&member_id=1125927879134394&client_id=1412d567c81586f16cdca9eecf524b7c&open_client_id=1125938713379114&rule_id=1125942052838863&jumpPage=callCarNow&require_level_list=5000&append_car=%5B%7B%22start_time%22%3A%2200%3A00%22%2C%22end_time%22%3A%2223%3A59%22%2C%22end_time_cross_day%22%3A0%2C%22wait_time%22%3A1%2C%22product_category_list%22%3A%225002%2C5003%2C5004%2C5005%2C5006%22%7D%5D

名称	是否必须	描述
rule_id	是	制度规则 id
jumpPage	是	跳转场景页面(参考参数使用说明) 实时用车为 callCarNow
approval_id	否	差旅、申请用车，必传
lat_from	否	如不传以定位获取的地址为起点
lng_from	否	如不传以定位获取的地址为起点
poi_from_name	否	如不传以定位获取的地址为起点
to_city_id	否	如不传以手动选择地址为终点
lat_to	否	如不传以手动选择地址为终点
lng_to	否	如不传以手动选择地址为终点
poi_to_name	否	如不传以手动选择地址为终点
city_id	否	如不传以手动选择地址为终点
passenger_phone	否	乘车人手机号，代叫必传
passenger_name	否	设置passenger_phone后可传入如不传入默认使用在滴滴管理后台填入的名称或乘客+手机号后四位
restrict_poi_flag	否	如需锁定地址，必传
restrict_passenger	否	如需锁定乘车人，必传
require_level_list	否	如需控制车型选择及默认勾选，必传
append_car	否	等待追加车型
callback_info	否	客户自定义自段，可关联订单信息
hide_estimate_price_flag	否	是否在预估页面隐藏价格相关信息 1 是 0 否，不传等于0

预约用车

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&rule_id={制度 id}&jumpPage=callCarAppointment&appointment_time=“明天|16:30”

名称	是否必须	描述
rule_id	是	制度规则 id
jumpPage	是	跳转场景页面(参考参数使用说明)，预约用车为callCarAppointment
approval_id	否	差旅、申请用车，必传
appointment_time	否	如需制定预约时间，必传，格式”今天\|14:30”，只支持[今天、明天、后天]
lat_from	否	如不传以定位获取的地址为起点
lng_from	否	如不传以定位获取的地址为起点
poi_from_name	否	如不传以定位获取的地址为起点
to_city_id	否	如不传以手动选择地址为终点
lat_to	否	如不传以手动选择地址为终点
lng_to	否	如不传以手动选择地址为终点
poi_to_name	否	如不传以手动选择地址为终点
city_id	否	如不传以手动选择地址为终点
passenger_phone	否	代叫必传
passenger_name	否	设置passenger_phone后可传入如不传入默认使用在滴滴管理后台填入的名称或乘客+手机号后四位
restrict_poi_flag	否	如需控制锁定地址，必传
hide_estimate_price_flag	否	是否在预估页面隐藏价格相关信息 1 是 0 否，不传等于0

实时接机

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&rule_id={制度 id}&jumpPage=airportPickUpNow&airport_id=1573

名称	是否必须	描述
rule_id	是	制度规则 id
jumpPage	是	跳转场景页面(参考参数使用说明)，实时接机为airportPickUpNow
airport_id	否	机场 id，如不传需手动选择
approval_id	否	差旅、申请用车，必传
to_city_id	否	如不传以手动选择地址为终点
lat_to	否	如不传以手动选择地址为终点
lng_to	否	如不传以手动选择地址为终点
poi_to_name	否	如不传以手动选择地址为终点
passenger_phone	否	代叫必传
passenger_name	否	设置passenger_phone后可传入如不传入默认使用在滴滴管理后台填入的名称或乘客+手机号后四位
restrict_poi_flag	否	如需控制锁定地址，必传
hide_estimate_price_flag	否	是否在预估页面隐藏价格相关信息 1 是 0 否，不传等于0

预约接机

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&rule_id={制度 id}&jumpPage=airportPickUp&flight_no=CZ8887&flight_depart_date=2024-07-14

名称	是否必须	描述
rule_id	是	制度规则 id
jumpPage	是	跳转场景页面(参考参数使用说明)，预约接机为airportPickUp
flight_no	否	航班号，如不传需手动选择
flight_depart_date	否	航班出发日期，如 flight_no有参数，此字段必传
approval_id	否	差旅、申请用车，必传
to_city_id	否	如不传以手动选择地址为终点
lat_to	否	如不传以手动选择地址为终点
lng_to	否	如不传以手动选择地址为终点
poi_to_name	否	如不传以手动选择地址为终点
passenger_phone	否	代叫必传
passenger_name	否	设置passenger_phone后可传入如不传入默认使用在滴滴管理后台填入的名称或乘客+手机号后四位
restrict_poi_flag	否	如需控制锁定地址，必传
hide_estimate_price_flag	否	是否在预估页面隐藏价格相关信息 1 是 0 否，不传等于0

送机

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&rule_id={制度 id}&jumpPage=toAirport&airport_id=1573

名称	是否必须	描述
rule_id	是	制度规则 id
jumpPage	是	跳转场景页面(参考参数使用说明)，送机为toAirport
airport_id	否	机场 id，如不传需手动选择
appointment_time	否	预约送机必传，格式为“今天｜14:30”
approval_id	否	差旅、申请用车，必传
city_id	否	如不传以手动选择地址为起点
lat_from	否	如不传以手动选择地址为起点
lng_from	否	如不传以手动选择地址为起点
poi_from_name	否	如不传以手动选择地址为起点
passenger_phone	否	代叫必传
passenger_name	否	设置passenger_phone后可传入如不传入默认使用在滴滴管理后台填入的名称或乘客+手机号后四位
restrict_poi_flag	否	如需控制锁定地址，必传
hide_estimate_price_flag	否	是否在预估页面隐藏价格相关信息 1 是 0 否，不传等于0

接站

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&rule_id={制度 id}&jumpPage=stationPickUp

名称	是否必须	描述
rule_id	是	制度规则 id
jumpPage	是	跳转场景页面(参考参数使用说明)，接站为stationPickUp
appointment_time	否	预约接站必传，格式为“今天｜14:30”
approval_id	否	差旅、申请用车，必传
lat_from	否	如不传以手动选择地址为起点
lng_from	否	如不传以手动选择地址为起点
poi_from_name	否	如不传以手动选择地址为起点
lat_from	否	如不传以手动选择地址为起点
city_id	否	如不传以手动选择地址为起点
to_city_id	否	如不传以手动选择地址为终点
lat_to	否	如不传以手动选择地址为终点
lng_to	否	如不传以手动选择地址为终点
poi_to_name	否	如不传以手动选择地址为终点
passenger_phone	否	代叫必传
passenger_name	否	设置passenger_phone后可传入如不传入默认使用在滴滴管理后台填入的名称或乘客+手机号后四位
restrict_poi_flag	否	如需控制锁定地址，必传
hide_estimate_price_flag	否	是否在预估页面隐藏价格相关信息 1 是 0 否，不传等于0

送站

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&rule_id={制度 id}&jumpPage=toStation

名称	是否必须	描述
rule_id	是	制度规则 id
jumpPage	是	跳转场景页面(参考参数使用说明)，送站为toStation
appointment_time	否	预约送站必传，格式为“今天｜14:30”
approval_id	否	差旅、申请用车，必传
lat_from	否	如不传以手动选择地址为起点
lng_from	否	如不传以手动选择地址为起点
poi_from_name	否	如不传以手动选择地址为起点
lat_from	否	如不传以手动选择地址为起点
city_id	否	如不传以手动选择地址为起点
to_city_id	否	如不传以手动选择地址为终点
lat_to	否	如不传以手动选择地址为终点
lng_to	否	如不传以手动选择地址为终点
poi_to_name	否	如不传以手动选择地址为终点
passenger_phone	否	代叫必传
passenger_name	否	设置passenger_phone后可传入如不传入默认使用在滴滴管理后台填入的名称或乘客+手机号后四位
restrict_poi_flag	否	如需控制锁定地址，必传
hide_estimate_price_flag	否	是否在预估页面隐藏价格相关信息 1 是 0 否，不传等于0

订单详情

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&order_id={订单 id}

名称	是否必须	描述
order_id	是	订单 id，无需传入 jumpPage参数

差旅单/审批单详情

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&approval_id={审批/差旅单 id}&jumpPage=travelList

名称	是否必须	描述
approval_id	是	审批单/差旅单 id
jumpPage	是	跳转地址为travelList

制度中心

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&jumpPage=ruleList

名称	是否必须	描述
jumpPage	是	跳转地址为ruleList

制度详情

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&institution_id={制度 id}&jumpPage=ruleDesc

名称	是否必须	描述
jumpPage	是	跳转地址为ruleDesc
institution_id	是	制度规则 id

订单列表

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&jumpPage=orderlist

名称	是否必须	描述
jumpPage	是	跳转地址为orderlist

发票与报销

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&jumpPage=invoice

名称	是否必须	描述
jumpPage	是	跳转地址为invoice

我的钱包

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&jumpPage=mywallet

名称	是否必须	描述
jumpPage	是	跳转地址为mywallet

客服中心

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&jumpPage=callCenter

名称	是否必须	描述
jumpPage	是	跳转地址为callCenter

常用地址设置

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&jumpPage=homeAddress

名称	是否必须	描述
jumpPage	是	跳转地址为homeAddress

包车页面

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&rule_id={制度 id}&jumpPage=charteredCar

名称	是否必须	描述
rule_id	是
jumpPage	是	跳转地址为charteredCar
approval_id	否

商旅H5页面：

访问方式

调用单点登录接口获取URL，单点登录接口https://api.es.xiaojukeji.com/river/Login/getLoginEncryptStr，并使用获取的URL拼接以下参数。

跳转对应的品类页面在请求URL时已经指定，请参考单点请求说明的product_type字段

响应结果示例：

{ 
  "errno": 0, 
  "errmsg": "SUCCESS", 
  "data": { 
        "encrypt_str": "https://client.es.xiaojukeji.com/entry/hotel?auth_code=eyJ0X3N0ciI6IjkyODkzNjQ0MWIxNjJiMzlhZmY0ZWYzMWZkOTAxMDRhIiwiY19zdHIiOiIyMDJlZGI0YzQ4ZThiMTdiMmU3MWE1MDI0NzI5NzZmZSIsInQiOjE2OTM5ODAzNzYsImhfc3RyIjoiYTUzYzNmNzE3OTYzOTgzODBjMDEyZWMwYTMxOTY2NzgifQ==&phone=00016034237&company_id=1125910319468282&client_id=1238f2427b47bf27ee6791c6b02ce486" 
  }, 
  "request_id": "b7tL/EnaLhrKCjnFa1OoNS7oC2IpABP13xDtW37wMdwmyVt/A8oIE6o8JcaK1BQj" 
}

商旅传参

名称	是否必须	描述
approval_id	否	审批单ID，注意：差旅场景必传
order_id	否	订单ID，注意：进入订单详情页面必传；
jump_page	否	跳转页 orderDetail:订单详情页注：此处的jump_page是小写的，和网约车页面跳转的jumpPage 的区别；

商旅品类预订

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&approval_id={审批/差旅单 id}

名称	是否必须	描述
auth_code	否
approval_id	否

订单详情页

跳转完整示例：

https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code={令牌}&order_id={订单号id}&jump_page=orderDetail

名称	是否必须	描述
auth_code	否
jump_page	否	orderDetail
order_id	否

版本记录

日期	更新人	更新内容	上线时间
2024.11.26	杨发杰	定制化参数增加 external_domain_version	2024.11.26
2024.12.6	杨发杰	代叫车增加参数 passenger_phone_country_code	2024.12.6
2025.01.22	杨发杰	用车增加参数 hide_estimate_price_flag	2024.12.10
2025.02.26	史文强	增加jumpPage参数	2025.02.26