发起叫车请求
说明
- 用户根据需要发起叫车请求,在发起请求之前必须先通过获取订单id接口获得order id
- 预约叫车,最多预约3天内(自然日)的用车,只能预约距离出发时间至少半个小时以上的用车
请求地址
/v1/order/Create/request
支持格式
Json或普通form
HTTP请求方式
Post
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
暂无
请求参数
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
client_id | string | yes | 申请应用时分配的AppKey |
access_token | string | yes | 授权后的access token |
timestamp | int | yes | 当前时间戳 |
sign | string | yes | 签名 详细算法参见 签名验证 章节 |
order_id | string | yes | 请求id 获取请参见 获取请求id |
rule | int | yes | 计价模型分类,201(专车);301(快车);203(专车接机);204(专车送机) |
type | int | yes | 订单类型,0(实时);1(预约) |
passenger_phone | string | no | 乘客手机号,不填表示给自己叫车 |
city | int | yes | 出发地城市 |
flat | float | yes | 出发地纬度 (当rule=203时,即接机实时、预约单时,该参数请务必传输机场列表查询接口中返回的航站楼的纬度) |
flng | float | yes | 出发地经度 (当rule=203时,即接机实时、预约单时,该参数请务必传输机场列表查询接口中返回的航站楼的经度) |
start_name | string | yes | 出发地名称(最多50个字) |
start_address | string | no | 出发地详细地址(最多100个字) |
tlat | float | no | 目的地纬度 (rule为201,301时必须) (当rule=203时,即送机实时、预约单时,该参数请务必传输机场列表查询接口中返回的航站楼的纬度) |
tlng | float | no | 目的地经度 (rule为201,301时必须) (当rule=204时,即送机实时、预约单时,该参数请务必传输机场列表查询接口中返回的航站楼的经度) |
end_name | string | no | 目的地名称(rule为201,301时必须,最多50个字) |
end_address | string | no | 目的地详细地址(rule为201,301时必须,最多100个字) |
clat | float | no | 当前位置纬度 |
clng | float | no | 当前位置经度 |
departure_time | datetime | no | 出发时间,不传表示现在用车(例如:2015-06-16 12:00:09) (当rule=203,且type=1时,请按规则拼装,规则:航班预计降落时间+depart_delay_time,我们会校验航班预计降落时间 + depart_delay_time是否与departure_time时间相同,若不同,返回参数错误,提示文案:“departure_time拼装错误,请按规则拼装”。例如:航班预计降落时间是2019-01-1 12:00:00,depart_delay_time=30,那么departure_time=2019-01-1 12:30:00) |
require_level | string | yes | 所需车型,车型代码。详情见:订单状态定义 |
flight_num | string | no | 航班号(rule为203时,该字段必填,且type=1时,此字段生效,如果该情况下此字段不传值,默认不需要航班延误等待服务。其他情况一律忽略该字段) |
flight_date | string | no | 航班出发日期(rule为203时该字段必填,例如:2019-01-10,请传航班信息查询接口中返回的航班出发当地日期) |
depart_delay_time | int | no | 航班到达后多少分钟出发,只能取10-90之间,10的整数倍数字。 (当rule为203时,该字段必填; 该字段与flight_num成对出现,要么都传,要么都不传,否则报错; 航班预计到达时间+该字段+航班日期,拼装出上面的departure_time字段) |
airport_id | int | no | 机场ID,通过城市机场列表接口或者航班信息查询接口获得。rule为203或204时,该字段必填; 接机实时单传输出发机场ID,送机实时单和送机预约单传输目的机场ID; 接机实时单的出发地经纬度请务必传输城市机场列表接口中返回的航站楼的经纬度; 送机实时单和送机预约单目的地经纬度请务必传输机场列表接口中返回的航站楼的经纬度; 接机预约单出发地经纬度请务必传输航班信息查询接口中返回的航站楼的经纬度。 |
app_time | datetime | yes | 客户端时间(例如:2015-06-16 12:00:09) |
map_type | enum | no | 地图类型,暂只支持soso |
combo_id | int | no | 套餐id |
sms_policy | int | no | 发送短信策略(0,为叫车人和乘车人都发送,1,乘车人发送叫车人不发,2乘车人不发叫车人发,3乘车人和叫车人都不发。默认-1,实时单不发短信) |
extra_info | string | no | 备注 |
callback_info | string | no | 透传的内容,在获取订单详情接口的时候会原样传递(最多100字符) |
dynamic_md5 | string | yes | 价格md5,通过 新的预估价接口获得 |
pricing_mode | int | no | 计价模式:0-普通计价 1-一口价 默认为0 |
enable_lineup | int | no | 是否允许排队:0,为不允许;1,为允许。默认为0 |
enable_reassign | int | no | 是否允许改派:0,为不允许;1,为允许。默认为0 |
version | string | no | 客户端版本号,例如"5.1.2" |
注意:
- enable_lineup中,订单是否会排队,由滴滴的大数据排队策略控制。该字段选择允许排队,则代表在该订单满足大数据排队策略时,自动进入队列进行排队;如不满足排队策略,即便该字段选择允许排队,订单也不会进入队列
- 当enable_lineup为1(允许排队)时,enable_reassign必须传1(允许改派),否则会报错
请求示例
方式一:
curl -X POST -H 'Content-Type: application/json' \
-d '{
"client_id": "testclient",
"access_token": "test",
"timestamp": "2867831074",
"sign": "test",
"order_id": "1125900046439052",
"rule": "201",
"type": "1",
"passenger_phone": "11000007172",
"city": "1",
"flat": "40.044648",
"flng": "116.321149",
"start_name": "当代城市家园",
"start_address": "北京市海淀区安宁庄西路18号",
"tlat": "40.039534",
"tlng": "116.323408",
"end_name": "奥林匹克森林公园",
"end_address": "北京市海淀区北辰西路28号",
"clat": "40.044648",
"clng": "116.321149",
"departure_time": "2017-07-29 15:15:00",
"require_level": "100",
"app_time": "2016-07-19 14:58:00",
"dynamic_md5": "0a5e79ed597988d685f8571d03030302",
}' https://api.es.xiaojukeji.com/v1/order/Create/request
方式二:
curl -i -X POST -H "Content-type:application/x-www-form-urlencoded" \
-d "client_id=testclient" \
-d "access_token=test" \
-d "timestamp=2867831074" \
-d "sign=sign" \
-d "order_id=1125900046439052" \
-d "rule=201" \
-d "passenger_phone=11000007172" \
-d "city=1" \
-d "flat=40.044648" \
-d "flng=116.321149" \
-d "start_name=当代城市家园" \
-d "start_address=北京市海淀区安宁庄西路18" \
-d "tlat=40.039534" \
-d "tlng=116.323408" \
-d "end_name=奥林匹克森林公园" \
-d "end_address=北京市海淀区北辰西路28号" \
-d "clat=40.044648" \
-d "clng=116.321149" \
-d "departure=2017-07-29 15:15:00" \
-d "require_level=100" \
-d "app_time=2016-07-19 14:58:00" \
-d "dynamic_md5=0a5e79ed597988d685f8571d03030302" \
https://api.es.xiaojukeji.com/v1/order/Create/request
返回参数说明
错误码请参见 常见错误解决方案章节
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
errno | int | 错误码 |
errmsg | string | 错误信息 |
data | object | |
data.order | object | 订单对象 |
data.order.id | string | 订单id |
data.order.city | int | 城市id |
data.order.type | int | 订单类型 |
data.order.call_phone | string | 叫车人手机号 |
data.order.passenger_phone | string | 乘车人手机号 |
data.order.status | int | 订单状态 查看详细 |
data.order.flat | float | 出发地纬度 |
data.order.flng | float | 出发地经度 |
data.order.tlat | float | 目的地纬度 |
data.order.tlng | float | 目的地经度 |
data.order.clat | float | 当前纬度 |
data.order.clng | float | 当前经度 |
data.order.start_name | string | 出发地名称 |
data.order.start_address | string | 出发地地址 |
data.order.end_name | string | 目的地名称 |
data.order.end_address | string | 目的地地址 |
data.order.extra_info | string | 留言 |
data.order.departure_time | datetime | 出发时间 |
data.order.order_time | datetime | 下单时间 |
data.order.require_level | string | 所需车型 |
data.order.remark | string | 备注 |
data.combo | object | 套餐对象 |
data.combo.time | int | 套餐时长 |
data.combo.distance | float | 套餐距离 |
data.combo.fee | float | 套餐价格 |
data.price | object | 价格对象 |
data.price.estimate | float | 预估车费 |
error_desc_h5 | string | 详细错误信息的H5页url; 如:乘客封禁了,这个字段就会返回乘客封禁H5页的url; 如:乘客需要录音录像授权,这个字段就会返回录音录像授权H5页的url。 |
data.need_record_permission | int | 是否需要授权录音,0:不需要授权,1:需要授权 |
data.need_video_permission | int | 是否需要授权录像,0:不需要授权,1:需要授权 |
返回示例
{
"errno": 0,
"errmsg": "SUCCESS",
"data": {
"order": {
"id": "4880109188406595918",
"city": "1",
"type": 0,
"call_phone": "13269661202",
"passenger_phone": "13269661202",
"status": 300,
"flng": 116.307479,
"flat": 40.045724,
"tlng": 116.800012,
"tlat": 39.689123,
"clng": 116.800012,
"clat": 39.689123,
"start_name": "得实大厦",
"start_address": "上地东路9号西南角",
"end_name": "万达广场",
"end_address": "北京市石景山区万达广场",
"departure_time": "2015-03-11 17:06:58",
"order_time": "2015-03-11 17:06:58",
"require_level": "100",
"extra_info": "这是订单备注",
},
"combo": {
"time": 120,
"distance": "12.1",
"fee": "120.50"
},
"price": {
"estimate": "20.12"
}
}
}
返回示例(下单失败)
{
"errno":"20051",
"errmsg":"乘客未授权录音录像",
"data":{
"need_record_permission":1,
"need_video_permission":1
},
"err_desc_h5":"https://xxxxxx"
}