使用说明:注意在微信内的使用
1、不支持在微信小程序中使用(不支持微信小程序支付)
2、微信公众号中可以使用
获取方式见 1.1 接入流程
特别注意:
H5接入域名
H5请求方式
正式环境请求,即使用正式环境域名、client_id 和 sign_key 即可
链接生成使用get方式带入对应参数,并通过跳转链接传递给WebApp,测试环境请求示例见下:
签名方式:对下表标注了“参与签名”的参数组成参数对(未标注的不参与签名),并进行升序排序,组装成字符串,然后进行sha1签名得到结果。 签名具体方法见 1.3 签名认证
参数名 | 是否必填 | 说明 |
---|---|---|
client_id | Y | 开放平台管理中心获取(参与签名) |
timestamp | Y | 时间戳(毫秒)(参与签名) |
ext_user_id | Y | 第三方用户ID,第三方唯一标识,ID由第三方生成(参与签名) |
ext_user_phone | N | 实际叫车人手机号(如果url中传递,则参与签名) |
ext_user_name | N | 实际叫车人用户名(如果url中传递,则参与签名) |
sign | Y | 免登签名(签名方式参考下方示例) |
phone | N | 乘车人手机号,若不传入,用户需要输入乘车人手机号才能叫车 |
phoneType | N | 0 可修改; 1 不可修改 |
useTime | N | 用车时间,格式为时间戳,预约单用车时间必须大于等于当前时间30分钟,不超过当前时间往后72小时 |
useTimeType | N | 0 可修改; 1 不可修改 |
start_time | N | 用车时间范围开始时间控制,格式为时间戳,传入后不支持修改 |
end_time | N | 用车时间范围结束时间控制,格式为时间戳,传入后不支持修改 |
start_city_codes | N | 起点城市范围控制,有多个用逗号(小写)隔开,传入后不可修改(开通城市citycode通过文档2.1接口获取) |
end_city_codes | N | 终点城市范围控制,有多个用逗号(小写)隔开,传入后不可修改(开通城市citycode通过文档2.1接口获取) |
startLg | N | 起点经度,高德坐标系(h5获取定位存在不稳定情况,接入方可传入起点经纬度提高用户体验) |
startLt | N | 起点纬度 |
startType | N | 0 起点可修改; 1 起点不可修改 |
endLg | N | 终点经度 |
endLt | N | 终点纬度 |
endType | N | 0 终点可修改; 1 终点不可修改 |
service_types | N | 控制服务车型:2 新能源;3 舒适型;4 豪华型;5 商务型;7 优选 |
canSecondCall | N | 该字段控制订单结束或订单取消后是否可以在H5页面继续通车。true 可以继续叫车; false 不可继续叫车,跳转至用车结束页,如需继续用车,需要用户关闭H5用车页,再重新进入。 |
route | N | 控制打开用户的页面,用户标识以第三方用户ID为准。journey:打开用户的订单列表;orderDetail:打开用户对应订单号的订单详情页(需要配合orderNo一起使用) |
orderNo | N | 当route=orderDetail时必传,orderNo为曹操订单号,订单号可通过5.3订单状态变更回调获取,或通过3.3订单列表查询接口获取 |
callback_info | N | 备注字段,订单事件变化回调通知会推送该备注 |