创建即时/预约/包车订单
说明
- 创建订单详情
地址URL
http:// <hqzx_DOMAIN>/v2/channel/open/order/createOrder
HTTP请求方式
POST
访问授权限制
需要验签，参见：鉴权说明
注意事项
1、车牌号不为空，为指定司机下单
2、若指定司机，那么是否接受系统指派其他司机，需传值，为空会设置默认值：接受其他司机
3、预约用车需预约时间若小于等于30分钟，时间太短，会按照及时订单逻辑找司机
请求参数
| 名称 | 类型 | 是否必选 | 说明 |
|---|---|---|---|
| estimatedId | String | yes | 预估ID |
| estimatedAmount | Double | yes | 预估金额(元) |
| cityId | int | yes | 城市ID |
| partnerOrderNo | String | yes | 合作方订单号 |
| serviceTypeId | int | yes | 服务类型ID，参见：服务类型 |
| riderName | String | yes | 乘车人姓名 |
| riderPhone | String | yes | 乘车人手机号(若是虚拟号需传乘客掩码手机号) |
| riderMaskPhone | String | no | 乘客掩码手机号,用于确认乘客真实后四位 |
| bookingDate | Long | yes | 预定日期(时间戳,毫秒级,13位) |
| bookingStartAddr | String | yes | 预定上车点地址 |
| bookingStartPoint | String | yes | 预定开始坐标经纬度(默认高德,精确小数点后6位) |
| bookingEndAddr | String | yes | 预定下车点地址 |
| bookingEndPoint | String | yes | 预定结束坐标经纬度(默认高德,精确小数点后6位) |
| bookingCarGroupId | int | yes | 车型ID,参见：车辆类型 |
| licensePlates | String | no | 车牌号，参见注意事项，与下方为组合条件 |
| isOtherDrivers | int | no | 是否接受选派其他司机：0不接受，1接受 |
| riderSign | String | no | 乘车人标记,定制化字段,例如区分是否VIP客户等 |
| wayList | Json | no | 途经地信息 |
途经地信息
| 名称 | 类型 | 说明 |
|---|---|---|
| wayPoint | String | 途经地坐标 |
| wayAddr | String | 途径地地址 |
请求示例
curl
-H "accept:application/json;charset=utf-8"
-H "Content-Type:application/json"
-H "channel:XXX" -H "sign:XXX"
-X POST '参见请求地址URL'
-d '
{
"estimatedId": "1234",
"estimatedAmount": 0,
"cityId": 107,
"partnerOrderNo": "144154568",
"serviceTypeId": 2,
"riderName": "张三",
"riderPhone": "15800000000",
"riderMaskPhone": "158****0000",
"bookingDate": 1582610400000,
"bookingStartAddr": "北京市朝阳市XXXX路",
"bookingStartPoint": "38.999746,117.817800",
"bookingEndAddr": "天津市滨海新区XXXX路",
"bookingEndPoint": "38.999746,117.817800",
"bookingCarGroupId": 34,
"licensePlates": "",
"isOtherDrivers": 1,
"riderSign": "超级vip",
"wayList": [{
"wayPoint": "116.512841,39.79381",
"wayAddr": "欢乐谷"
}]
}
'
返回结构说明
参见：接口说明
返回结果说明
| 名称 | 类型 | 说明 |
|---|---|---|
| orderNo | String | 订单号 |
返回示例
{
"code":1,
"msg":"SUCCESS",
"data":{
"orderNo":"XXXX"
}
}