5.2 用车H5企业版接入 描述的是免登跳转到曹操 H5 用车页面的接入方式,用车过程(叫单、支付等)都在曹操提供的 H5 页面内完成。
若接入方不使用曹操提供的 H5 页面,而是自行搭建用车页面、只对接了预估价格接口(如 2.6 预估价格带明细),则后续叫单需调用本接口,不能直接调用 2.7 下单叫车 中的通用 orderCar/orderCarV2——本接口内部会校验免登用户、企业用车规则、企业H5一口价等企业H5专属逻辑,通用叫单接口不具备这些校验。
仅支持多车型同时呼叫(不支持传单车型)。该接口对 ext_order_id 幂等,只要创建订单成功就算成功,司机接单会回调接入方(回调状态见《1.5 订单状态及类型》)。派单等待时长120s,如120s后附近无司机接单,则订单会被系统撤销,需要改变ext_order_id重新下单。
调用本接口前,ext_uid 对应的用户须先完成免登(见开放平台 H5免登接口),否则返回"用户不存在"。
请求地址: /v2/common/orderCarH5Use
服务协议: HTTP/POST
Content-Type: application/x-www-form-urlencoded
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| client_id | string | Y | 申请时的client_id |
| timestamp | long | Y | 时间戳 |
| sign | string | Y | 签名 |
| ext_uid | string | Y | 第三方用户ID,需为已完成免登的用户(对应 5.2 节 URL 中的 ext_user_id),不存在则报"用户不存在" |
| owner | string | Y | 订单归属,本接口必传,不传会导致下单接口报"系统错误"。 企业H5场景固定传 2(企业订单)。取值:1 个人订单;2 企业订单;3 个人支付需报销;4 混合支付 |
| ext_order_id | string | Y | 外部接入方的订单ID,最长30个字符(外部订单ID唯一,禁止重复),叫单前会加分布式锁 |
| from_longitude | string | Y | 出发地经度 |
| from_latitude | string | Y | 出发地纬度 |
| to_longitude | string | Y | 目的地经度 |
| to_latitude | string | Y | 目的地纬度 |
| caller_phone | string | Y | 用户手机号 |
| city_code | string | Y | 城市编码(与起点对应的citycode保持一致) |
| order_type | string | Y | 订单类型,请参照《1.5 订单状态及类型》 |
| start_name | string | Y | 出发点名称(最多16个字) |
| start_address | string | N | 出发点详细地址,展示在司机端(最多100个字),不传则使用 start_name |
| end_name | string | Y | 目的地名称(最多16个字) |
| end_address | string | N | 目的地详细地址,展示在司机端(最多100个字),不传则使用 end_name |
| is_simultaneously_call | string | Y | 固定传 "1"(本接口仅支持多车型同时呼叫) |
| service_type_price | string | Y | 多车型同时呼叫车型、预估价格和预估key的对应信息,Json格式的list,元素为 serviceType(车型)、estimateKey(预估Key)、estimatePrice(预估价,分),须与预估接口返回的一一对应,否则报错 |
| accept_relay_order | string | N | 是否允许派接力单(0不允许、1允许),默认为允许派接力单 |
| carpool_type | int | N | 是否允许拼车:0 不拼车;1 允许拼车,默认为不拼车 |
| sms_policy | string | N | 短信发送--1:叫车人和乘车人都发送;2:乘车人发送叫车人不发送;3:乘车人不发叫车人发;4:乘车人叫车人都不发 |
| ruleId | long | N | 用车规则ID,传入后会校验规则是否存在及使用场景是否受限 |
service_type_price例子:
[
{"serviceType":2, "estimateKey":"867c5a62-b934-4d9d-ac5d-668851b6cffe-2-0", "estimatePrice":1596},
{"serviceType":3, "estimateKey":"651c4a17-195f-4e6e-8d32-108698f13a9a-3-0", "estimatePrice":1596}
]
{
"ext_order_id": "Test_1788430937586",
"sign": "1ad410148a1f1a94abdeb1d7e421cabd1c71ad23",
"city_code": "027",
"is_simultaneously_call": "1",
"from_latitude": "30.480134",
"client_id": "f7755e27e2658fe5",
"accept_relay_order": "0",
"start_name": "光谷总部时代",
"to_longitude": "114.438553",
"caller_phone": "18971624656",
"from_longitude": "114.421809",
"start_address": "湖北省武汉市江夏区光谷大道35号光谷总部时代1栋1801",
"ext_uid": "160023420",
"owner": "2",
"to_latitude": "30.442948",
"end_name": "平安光谷春天",
"end_address": "湖北省武汉市江夏区高新六路15号平安光谷春天",
"carpool_type": "0",
"order_type": "1",
"sms_policy": "1",
"service_type_price": "[{\"serviceType\":2,\"estimateKey\":\"867c5a62-b934-4d9d-ac5d-668851b6cffe-2-0\",\"estimatePrice\":1737},{\"serviceType\":3,\"estimateKey\":\"651c4a17-195f-4e6e-8d32-108698f13a9a-3-0\",\"estimatePrice\":1737}]",
"timestamp": "1788430097033"
}
响应data参数:
| 参数名称 | 类型 | 必有 | 说明 |
|---|---|---|---|
| orderNo | long | Y | 订单号 |
结果示例:
{
"code": 200,
"success": true,
"data": {
"orderNo": 1331700502790
}
}
owner 为必传参数:不传会命中服务端"个人未支付账户风控校验"环节的空指针,直接返回 {"code":1,"msg":"系统错误"},企业H5场景固定传 2。ext_uid 对应的用户已完成免登,否则返回"用户不存在"。