发起叫车请求

说明

  1. 用户根据需要发起叫车请求,在发起请求之前必须先通过获取订单id接口获得order id
  2. 预约叫车,最多预约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"

注意:

  1. enable_lineup中,订单是否会排队,由滴滴的大数据排队策略控制。该字段选择允许排队,则代表在该订单满足大数据排队策略时,自动进入队列进行排队;如不满足排队策略,即便该字段选择允许排队,订单也不会进入队列
  2. 当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"
}

results matching ""

    No results matching ""