订单请求

优质
小牛编辑
149浏览
2023-12-01

说明

  1. 用户根据需要发起叫车请求,在发起请求之前必须先通过获取订单id接口获得order id
  2. 预约叫车,最多预约3天内(自然日)的用车,只能预约距离出发时间至少半个小时以上的用车

请求地址

/v1/order/Create/request

支持格式

Json或普通form

HTTP请求方式

Post

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制

暂无

请求参数

名称类型必选描述
client_idstringyes申请应用时分配的AppKey
access_tokenstringyes授权后的access token
timestampintyes当前时间戳
signstringyes签名 详细算法参见 签名验证 章节
order_idstringyes请求id 获取请参见 获取请求id
ruleintyes计价模型分类,201(专车);301(快车);203(专车接机);204(专车送机)
typeintyes订单类型,0(实时);1(预约)
passenger_phonestringno乘客手机号,不填表示给自己叫车
cityintyes出发地城市
flatfloatyes出发地纬度
(当rule=203时,即接机实时、预约单时,该参数请务必传输机场列表查询接口中返回的航站楼的纬度)
flngfloatyes出发地经度
(当rule=203时,即接机实时、预约单时,该参数请务必传输机场列表查询接口中返回的航站楼的经度)
start_namestringyes出发地名称(最多50个字)
start_addressstringno出发地详细地址(最多100个字)
tlatfloatno目的地纬度
(rule为201,301时必须)
(当rule=203时,即送机实时、预约单时,该参数请务必传输机场列表查询接口中返回的航站楼的纬度)
tlngfloatno目的地经度
(rule为201,301时必须)
(当rule=204时,即送机实时、预约单时,该参数请务必传输机场列表查询接口中返回的航站楼的经度)
end_namestringno目的地名称(rule为201,301时必须,最多50个字)
end_addressstringno目的地详细地址(rule为201,301时必须,最多100个字)
clatfloatno当前位置纬度
clngfloatno当前位置经度
departure_timedatetimeno出发时间,不传表示现在用车(例如: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_levelstringyes所需车型,车型代码。详情见:订单状态定义
flight_numstringno航班号(rule为203时,该字段必填,且type=1时,此字段生效,如果该情况下此字段不传值,默认不需要航班延误等待服务。其他情况一律忽略该字段)
flight_datestringno航班出发日期(rule为203时该字段必填,例如:2019-01-10,请传航班信息查询接口中返回的航班出发当地日期)
depart_delay_timeintno航班到达后多少分钟出发,只能取10-90之间,10的整数倍数字。
(当rule为203时,该字段必填;
该字段与flight_num成对出现,要么都传,要么都不传,否则报错;
航班预计到达时间+该字段+航班日期,拼装出上面的departure_time字段)
airport_idintno机场ID,通过城市机场列表接口或者航班信息查询接口获得。rule为203或204时,该字段必填;
接机实时单传输出发机场ID,送机实时单和送机预约单传输目的机场ID;
接机实时单的出发地经纬度请务必传输城市机场列表接口中返回的航站楼的经纬度;
送机实时单和送机预约单目的地经纬度请务必传输机场列表接口中返回的航站楼的经纬度;
接机预约单出发地经纬度请务必传输航班信息查询接口中返回的航站楼的经纬度。
app_timedatetimeyes客户端时间(例如:2015-06-16 12:00:09)
map_typeenumno地图类型,暂只支持soso
combo_idintno套餐id
sms_policyintno发送短信策略(0,为叫车人和乘车人都发送,1,乘车人发送叫车人不发,2乘车人不发叫车人发,3乘车人和叫车人都不发。默认-1,实时单不发短信)
extra_infostringno备注
callback_infostringno透传的内容,在获取订单详情接口的时候会原样传递(最多100字符)
dynamic_md5stringyes价格md5,通过 新的预估价接口获得
pricing_modeintno计价模式:0-普通计价 1-一口价 默认为0
enable_lineupintno是否允许排队:0,为不允许;1,为允许。默认为0
enable_reassignintno是否允许改派:0,为不允许;1,为允许。默认为0
versionstringno客户端版本号,例如"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",
}'  http://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" \
http://api.es.xiaojukeji.com/v1/order/Create/request

返回参数说明

错误码请参见 常见错误解决方案章节

返回值字段字段类型字段说明
errnoint错误码
errmsgstring错误信息
dataobject
data.orderobject订单对象
data.order.idstring订单id
data.order.cityint城市id
data.order.typeint订单类型
data.order.call_phonestring叫车人手机号
data.order.passenger_phonestring乘车人手机号
data.order.statusint订单状态 查看详细
data.order.flatfloat出发地纬度
data.order.flngfloat出发地经度
data.order.tlatfloat目的地纬度
data.order.tlngfloat目的地经度
data.order.clatfloat当前纬度
data.order.clngfloat当前经度
data.order.start_namestring出发地名称
data.order.start_addressstring出发地地址
data.order.end_namestring目的地名称
data.order.end_addressstring目的地地址
data.order.extra_infostring留言
data.order.departure_timedatetime出发时间
data.order.order_timedatetime下单时间
data.order.require_levelstring所需车型
data.order.remarkstring备注
data.comboobject套餐对象
data.combo.timeint套餐时长
data.combo.distancefloat套餐距离
data.combo.feefloat套餐价格
data.priceobject价格对象
data.price.estimatefloat预估车费
error_desc_h5string详细错误信息的H5页url;
如:乘客封禁了,这个字段就会返回乘客封禁H5页的url;
如:乘客需要录音录像授权,这个字段就会返回录音录像授权H5页的url。
data.need_record_permissionint是否需要授权录音,0:不需要授权,1:需要授权
data.need_video_permissionint是否需要授权录像,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":"http://xxxxxx"
}