# H5打车接入说明

# 一、创建H5应用

  1. 使用开发者账号登录享道出行开放平台 ,进入管理中心 创建应用。
  2. 创建应用时,对接类型选择H5。
  3. 创建应用成功后,可在应用详情页面查看应用App ID和App Key,用以进行商户鉴权。
  4. 若要获取订单信息,请查看【用车接口-订单信息同步、订单详情】
  5. 若要获取订单支付信息,请查看【用车接口-支付状态同步(合作方)】
  6. 若要跳转至第三方收银台完成用户支付,请查看【H5打车接入说明-H5打车跳转第三方收银台】

# 二、认证过程

H5 打车认证过程

# 三、获取登陆凭证

# 服务提供方

享道

# 接口URL

/openapi/certificate/get

# 请求方式

POST

# 请求频次

单次

# 请求参数

参数名称 类型 必选 说明
mobile string 用户手机号
openId string 第三方平台用户唯一识别ID

# 响应参数

参数名称 类型 必有 说明
errCode string 服务响应状态,参见附录
errMsg string 服务响应状态说明
content object 数据体
content.ticket string 访问票据
content.uid string 享道用户账号唯一识别

# 四、获取登陆凭证

组装URL如下:

若为网约车H5:

https://xxx/trip-h5/login?ticket=XXX&appId=XXX&deviceId=XXX&platform=XXX&appVersion=XXX &cityCode=XXX&promotorCode=XXX&channelCode=XXX&source=XXX

若为企业级H5:

https://xxx/enterprise-h5/#/login?ticket=XXX&appId=XXX&deviceId=XXX&platform=XXX&appVersion=XXX &cityCode=XXX&promotorCode=XXX&channelCode=XXX&source=XXX

XXX根据环境不同有以下两种:

若为网约车H5:

  • 测试环境: https://h5dache-sit.saicmobility.com
  • 生产环境: https://h5dache.saicmobility.com

若为企业级H5:

  • 测试环境: https://h5dache-ep-sit.saicmobility.com
  • 生产环境: https://h5dache-ep.saicmobility.com